SolidWorksMakroprogrammierung

Objekt · SldWorks

CalloutVariable-Objekt

Eine Variable in einer Bohrungsbeschreibung, etwa ein Durchmesser oder eine Tiefe: Name, Art, Toleranz und Passung.

Deklaration Dim x As SldWorks.CalloutVariable · in der englischen .NET-Hilfe: ICalloutVariable

Beschreibung

CalloutVariable gibt Zugriff auf eine Bohrungsbeschreibung. Gemeint ist eine einzelne Variable darin, etwa ein Durchmesser, eine Tiefe oder ein Senkwinkel. DisplayDimension.GetHoleCalloutVariables liefert alle Variablen einer Bohrungsbeschreibung als CalloutVariable-Objekte. Den Wert liest du über die abgeleiteten Objekte CalloutLengthVariable, CalloutAngleVariable und CalloutStringVariable. Toleranz und Passung setzt du hier.

Zugriff

Beispiel

' Gibt für jede Variable der ausgewählten Bohrungsbeschreibung Namen, Art und Toleranzart aus
' und stellt bei Längen eine zweiseitige Toleranz ein, wie das Hilfebeispiel.
' Vorbedingung: Eine Zeichnung ist offen, eine Bohrungsbeschreibung ist ausgewählt.
' Ergebnis:     Die Werte stehen im Direktfenster, die Längen haben eine zweiseitige Toleranz.
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swSel As Object
    Dim swDispDim As SldWorks.DisplayDimension
    Dim swVar As SldWorks.CalloutVariable
    Dim swModelView As SldWorks.ModelView
    Dim vVariablen As Variant
    Dim i As Long

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Then Exit Sub
    Set swSel = swModel.SelectionManager.GetSelectedObject6(1, -1)
    If Not TypeOf swSel Is SldWorks.DisplayDimension Then Exit Sub
    Set swDispDim = swSel
    If False = swDispDim.IsHoleCallout Then Exit Sub

    vVariablen = swDispDim.GetHoleCalloutVariables
    If Not IsArray(vVariablen) Then Exit Sub
    For i = 0 To UBound(vVariablen)
        Set swVar = vVariablen(i)
        Debug.Print swVar.UserReadableVariableName & " (" & swVar.VariableName & ")"
        Debug.Print "  Art: " & swVar.Type & ", Variable: " & swVar.VariableType & ", Toleranzart: " & swVar.ToleranceType
        If swVar.Type = swCalloutVariableType_Length Then
            swVar.ToleranceType = swTolBILAT
            Debug.Print "  Toleranz: " & swVar.ToleranceMax * 1000 & " / " & swVar.ToleranceMin * 1000 & " mm"
        End If
    Next i

    Set swModelView = swModel.ActiveView
    swModelView.GraphicsRedraw Empty                    ' erst danach ist die Änderung zu sehen
End Sub

Bemerkungen

Abgeleitete Objekte: CalloutLengthVariable, CalloutAngleVariable und CalloutStringVariable erben von CalloutVariable. Welches davon vorliegt, sagt CalloutVariable.Type. Dann weist du die Variable einer Variablen dieses Typs zu und liest dort den Wert, wie im Hilfebeispiel „Get and Set Hole Callout Variables“.

Neu zeichnen: Änderungen an CalloutVariable.ToleranceType, CalloutVariable.HoleFit, CalloutVariable.ShaftFit und CalloutVariable.FitDisplayStyle siehst du erst nach ModelView.GraphicsRedraw.

Toleranz bei Bohrungsbeschreibungen: Seit SOLIDWORKS 2016 setzt du Toleranzart und Klammern bei Bohrungsbeschreibungen hier. DimensionTolerance.Type und DimensionTolerance.ShowParenthesis überschreiben diese Einstellungen nicht.

Passung: CalloutVariable.FitType gibt es nur bei den Toleranzarten für Passungen. Schrifthöhe und Faktor der Passung (CalloutVariable.FitTextHeight, CalloutVariable.FitTextScale) gelten nur bei Passung und Passung mit Toleranz.

Einheiten: Für CalloutVariable.ToleranceMax, CalloutVariable.ToleranceMin, CalloutVariable.TextHeight und CalloutVariable.FitTextHeight nennt die Hilfe keine Einheit. Vermutlich sind es wie sonst in der API Meter.

In SOLIDWORKS 2024 liefert DisplayDimension.GetHoleCalloutVariables für Bohrungsbeschreibungen an Bohrungen aus dem Bohrungsassistenten und an erweiterten Bohrungen Empty statt eines Arrays. Die Einheit der Toleranzen und Schrifthöhen ist nicht belegt.

Eigenschaften und Methoden

Eigenschaften 18, davon 18 beschrieben

NameBeschreibung
FitDisplayStyleLiest oder setzt, wie die Passung in der Bohrungsbeschreibung angezeigt wird, etwa übereinander oder in einer Zeile.
FitTextHeightLiest oder setzt die Schrifthöhe der Passung in der Bohrungsbeschreibung.
FitTextScaleLiest oder setzt den Faktor, mit dem die Schrift der Passung in der Bohrungsbeschreibung skaliert wird.
FitTypeLiest oder setzt die Art der Passung in der Bohrungsbeschreibung, etwa Spiel- oder Übergangspassung.
FitUseTextScaleLiest oder setzt, ob die Schrift der Passung mit dem Faktor aus FitTextScale skaliert wird.
HoleFitLiest oder setzt die Passung der Bohrung in der Bohrungsbeschreibung.
ShaftFitLiest oder setzt die Passung der Welle in der Bohrungsbeschreibung.
ShowParenthesisLiest oder setzt, ob die Toleranz in der Bohrungsbeschreibung in Klammern steht.
TextHeightLiest oder setzt die Schrifthöhe der Toleranz in der Bohrungsbeschreibung.
TextScaleLiest oder setzt den Faktor, mit dem die Schrift der Toleranz in der Bohrungsbeschreibung skaliert wird.
ToleranceMaxLiest oder setzt den oberen Toleranzwert der Bohrungsbeschreibung.
ToleranceMinLiest oder setzt den unteren Toleranzwert der Bohrungsbeschreibung.
ToleranceTypeLiest oder setzt die Toleranzart der Bohrungsbeschreibung, etwa zweiseitig, symmetrisch oder Passung.
TypeLiefert die allgemeine Art der Variablen: Länge, Winkel oder Text.
UserReadableVariableNameLiefert den Namen der Variablen, wie er im PropertyManager der Bemaßung in der Liste „Callout value“ steht.
UseTextScaleLiest oder setzt, ob die Schrift der Toleranz mit dem Faktor aus TextScale skaliert wird.
VariableNameLiefert den Namen der Variablen, wie er im PropertyManager der Bemaßung im Textfeld für den Bemaßungstext steht.
VariableTypeLiefert, welche Variable es genau ist, etwa der Durchmesser oder die Tiefe einer bestimmten Bohrungsart.

Siehe auch

Englisches Original: ICalloutVariable in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)

Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.