SolidWorksMakroprogrammierung

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.

Deklaration Dim x As SldWorks.DimensionTolerance · in der englischen .NET-Hilfe: IDimensionTolerance

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

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 Sub

Bemerkungen

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

NameBeschreibung
FitDisplayStyleLiest oder setzt, wie die Passung an der Bemaßung erscheint: übereinander mit Linie, übereinander oder in einer Zeile.
FitTypeLiest oder setzt die Passungsart der Bemaßung, etwa Spiel-, Übergangs- oder Presspassung.
ShowParenthesisLiest oder setzt, ob die Toleranz der Bemaßung in Klammern steht.
TypeLiest oder setzt die Toleranzart der Bemaßung, etwa keine, zweiseitig, symmetrisch, Grenzmaße oder Passung.

Methoden 19, davon 16 beschrieben, 3 veraltet

NameBeschreibung
GetFitFontHeightLiefert die feste Höhe der Schrift der Passung.
GetFitFontScaleLiefert das Verhältnis der Höhe der Schrift der Passung zur Höhe der Schrift der Bemaßung.
GetFitFontUseDimensionLiefert, ob die Schrift der Passung so groß ist wie die Schrift der Bemaßung.
GetFitFontUseScaleLiefert, ob die Schrift der Passung mit einem Faktor zur Schrift der Bemaßung skaliert wird oder eine feste Höhe hat.
GetFontHeightLiefert die feste Höhe der Schrift der Toleranz.
GetFontScaleLiefert das Verhältnis der Höhe der Schrift der Toleranz zur Höhe der Schrift der Bemaßung.
GetFontUseDimensionLiefert, ob die Schrift der Toleranz so groß ist wie die Schrift der Bemaßung.
GetFontUseScaleLiefert, ob die Schrift der Toleranz mit einem Faktor zur Schrift der Bemaßung skaliert wird oder eine feste Höhe hat.
GetHoleFitValueLiefert die Passung der Bohrung, etwa „H7“.
GetMaxValueveraltet ersetzt durch DimensionTolerance.GetMaxValue2
GetMaxValue2Liefert die obere Grenze der Toleranz und ob sie zur Toleranzart passt.
GetMinValueveraltet ersetzt durch DimensionTolerance.GetMinValue2
GetMinValue2Liefert die untere Grenze der Toleranz und ob sie zur Toleranzart passt.
GetShaftFitValueLiefert die Passung der Welle, etwa „g6“.
SetFitFontLegt die Größe der Schrift der Passung fest: wie die Bemaßung, mit einem Faktor oder mit fester Höhe.
SetFitValuesSetzt die Passung von Bohrung und Welle, etwa H7 und g6.
SetFontLegt die Größe der Schrift der Toleranz fest: wie die Bemaßung, mit einem Faktor oder mit fester Höhe.
SetValuesveraltet ersetzt durch DimensionTolerance.SetValues2
SetValues2Setzt 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.