Objekt · SldWorks
DimensionTolerance-Objekt
Die Toleranz einer Bemaßung: Toleranzart, obere und untere Grenze, Passung von Bohrung und Welle sowie die Schriftgröße von Toleranz und Passung.
Beschreibung
Mit DimensionTolerance liest und setzt du die Toleranz einer Bemaßung. Zu jeder Dimension gehört ein DimensionTolerance-Objekt. Es legt die Toleranzart fest, also etwa keine, zweiseitig, symmetrisch, Grenzmaße oder Passung (swTolType_e). Dazu kommen je nach Art die obere und untere Grenze oder die Passung von Bohrung und Welle. Die meisten Befehle gibt es seit SOLIDWORKS 2006, SetValues2 seit SOLIDWORKS 2013 SP04, GetMaxValue2 und GetMinValue2 seit SOLIDWORKS 2015 SP03 und FitType seit SOLIDWORKS 2016.
Zugriff
Dimension.Tolerance: die Toleranz einer Bemaßung. DieDimensionbekommst du etwa mitModelDoc2.Parameteroder aus einer angeklickten Bemaßung (DisplayDimension) mitDisplayDimension.GetDimension2.
Die Hilfe nennt nur diesen Zugriff. Ihre Beispiele holen es aus der Auswahl: SelectionMgr.GetSelectedObject6 liefert die DisplayDimension, GetDimension2(0) die Dimension und Tolerance die Toleranz.
Beispiel
' Gibt Toleranzart, Grenzen und Passung der ausgewählten Bemaßung aus.
' Vorbedingung: In einem Teil, einer Baugruppe oder einer Zeichnung ist eine Bemaßung angeklickt.
' Ergebnis: Die Werte stehen im Direktfenster.
Option Explicit
Sub main()
Dim swApp As SldWorks.SldWorks
Dim swModel As SldWorks.ModelDoc2
Dim swSelMgr As SldWorks.SelectionMgr
Dim swDispDim As SldWorks.DisplayDimension
Dim swDim As SldWorks.Dimension
Dim swTol As SldWorks.DimensionTolerance
Dim dMax As Double
Dim dMin As Double
Set swApp = Application.SldWorks
Set swModel = swApp.ActiveDoc
If swModel Is Nothing Then Exit Sub
Set swSelMgr = swModel.SelectionManager
If swSelMgr.GetSelectedObjectType3(1, -1) <> swSelDIMENSIONS Then Exit Sub
Set swDispDim = swSelMgr.GetSelectedObject6(1, -1)
Set swDim = swDispDim.GetDimension2(0)
Set swTol = swDim.Tolerance
Debug.Print swDim.FullName & ": Toleranzart " & swTol.Type
Select Case swTol.Type
Case swTolNONE
Debug.Print "Keine Toleranz"
Case swTolFIT, swTolFITWITHTOL, swTolFITTOLONLY
Debug.Print "Passung " & swTol.GetHoleFitValue & "/" & swTol.GetShaftFitValue & _
", Passungsart " & swTol.FitType
End Select
If swTol.GetMaxValue2(dMax) = swDimensionTolerance_ValidForType Then
Debug.Print "Obere Grenze: " & dMax * 1000 & " mm"
End If
If swTol.GetMinValue2(dMin) = swDimensionTolerance_ValidForType Then
Debug.Print "Untere Grenze: " & dMin * 1000 & " mm"
End If
End SubBemerkungen
Toleranzart zuerst: Welche Befehle wirken, hängt von DimensionTolerance.Type ab. Bei swTolNONE kannst du keine Grenzen mit DimensionTolerance.SetValues2 setzen. DimensionTolerance.FitType gibt es nur bei den Passungsarten swTolFIT, swTolFITTOLONLY und swTolFITWITHTOL, DimensionTolerance.ShowParenthesis nur bei zweiseitiger und symmetrischer Toleranz und bei Passung mit Toleranz. Je nach Toleranzart sind obere und untere Grenze nicht sichtbar. Ob ein Wert zur Art passt, meldet DimensionTolerance.GetMaxValue2 mit einem Wert aus swDimensionToleranceWarning_e.
Neu zeichnen: Änderungen siehst du erst nach dem Neuzeichnen. Die Hilfe nennt dafür meist die veraltete Methode ModelDoc2.GraphicsRedraw2, bei SetValues2 ModelView.GraphicsRedraw. Nimm ModelView.GraphicsRedraw, etwa mit swModel.ActiveView.GraphicsRedraw Empty.
Bohrungsbeschriftungen: Hat eine Bemaßung einer Bohrung mehrere Werte in der Beschriftung, setzt du Toleranzart, Darstellung der Passung und Klammern ab SOLIDWORKS 2016 mit CalloutVariable (CalloutVariable.ToleranceType, CalloutVariable.FitDisplayStyle, CalloutVariable.ShowParenthesis). Die Befehle von DimensionTolerance überschreiben diese Einstellungen nicht.
Schrift: Für die Schrift der Toleranz und die Schrift der Passung gibt es je fünf Befehle. Die Schrift ist entweder so groß wie die Bemaßung, ein Vielfaches davon oder hat eine feste Höhe. Die Höhe liefert die Hilfe in Systemeinheiten, also Meter.
Einheiten der Grenzen: Für obere und untere Grenze nennt die Hilfe keine Einheit. Bei Längen sind es Meter, bei Winkeln vermutlich Bogenmaß wie bei den Toleranzwerten von ModelDocExtension.EditDimensionProperties. Ob ein unteres Abmaß negativ anzugeben ist, sagt die Hilfe nicht.
Veraltet: GetMaxValue, GetMinValue und SetValues sind veraltet. Nachfolger sind DimensionTolerance.GetMaxValue2, DimensionTolerance.GetMinValue2 und DimensionTolerance.SetValues2.
Bei einer Passung wie H7/g6 liefern DimensionTolerance.GetMaxValue2 und DimensionTolerance.GetMinValue2 die Abmaße der Welle (g6) in Metern, nicht die Grenzmaße.
Eigenschaften und Methoden
Eigenschaften 4, davon 4 beschrieben
| Name | Beschreibung |
|---|---|
| FitDisplayStyle | Liest oder setzt, wie die Passung an der Bemaßung erscheint: übereinander mit Linie, übereinander oder in einer Zeile. |
| FitType | Liest oder setzt die Passungsart der Bemaßung, etwa Spiel-, Übergangs- oder Presspassung. |
| ShowParenthesis | Liest oder setzt, ob die Toleranz der Bemaßung in Klammern steht. |
| Type | Liest oder setzt die Toleranzart der Bemaßung, etwa keine, zweiseitig, symmetrisch, Grenzmaße oder Passung. |
Methoden 19, davon 16 beschrieben, 3 veraltet
| Name | Beschreibung |
|---|---|
| GetFitFontHeight | Liefert die feste Höhe der Schrift der Passung. |
| GetFitFontScale | Liefert das Verhältnis der Höhe der Schrift der Passung zur Höhe der Schrift der Bemaßung. |
| GetFitFontUseDimension | Liefert, ob die Schrift der Passung so groß ist wie die Schrift der Bemaßung. |
| GetFitFontUseScale | Liefert, ob die Schrift der Passung mit einem Faktor zur Schrift der Bemaßung skaliert wird oder eine feste Höhe hat. |
| GetFontHeight | Liefert die feste Höhe der Schrift der Toleranz. |
| GetFontScale | Liefert das Verhältnis der Höhe der Schrift der Toleranz zur Höhe der Schrift der Bemaßung. |
| GetFontUseDimension | Liefert, ob die Schrift der Toleranz so groß ist wie die Schrift der Bemaßung. |
| GetFontUseScale | Liefert, ob die Schrift der Toleranz mit einem Faktor zur Schrift der Bemaßung skaliert wird oder eine feste Höhe hat. |
| GetHoleFitValue | Liefert die Passung der Bohrung, etwa „H7“. |
| GetMaxValue | veraltet ersetzt durch DimensionTolerance.GetMaxValue2 |
| GetMaxValue2 | Liefert die obere Grenze der Toleranz und ob sie zur Toleranzart passt. |
| GetMinValue | veraltet ersetzt durch DimensionTolerance.GetMinValue2 |
| GetMinValue2 | Liefert die untere Grenze der Toleranz und ob sie zur Toleranzart passt. |
| GetShaftFitValue | Liefert die Passung der Welle, etwa „g6“. |
| SetFitFont | Legt die Größe der Schrift der Passung fest: wie die Bemaßung, mit einem Faktor oder mit fester Höhe. |
| SetFitValues | Setzt die Passung von Bohrung und Welle, etwa H7 und g6. |
| SetFont | Legt die Größe der Schrift der Toleranz fest: wie die Bemaßung, mit einem Faktor oder mit fester Höhe. |
| SetValues | veraltet ersetzt durch DimensionTolerance.SetValues2 |
| SetValues2 | Setzt die untere und obere Grenze der Toleranz, wahlweise je Konfiguration. |
Siehe auch
Englisches Original: IDimensionTolerance in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.