SolidWorksMakroprogrammierung

Objekt · SldWorks

CalloutLengthVariable-Objekt

Eine Längenvariable in einer Bohrungsbeschreibung, etwa ein Durchmesser oder eine Tiefe: der Wert und die Nachkommastellen von Wert und Toleranz.

Deklaration Dim x As SldWorks.CalloutLengthVariable · in der englischen .NET-Hilfe: ICalloutLengthVariable

Beschreibung

CalloutLengthVariable gibt Zugriff auf eine Längenvariable in einer Bohrungsbeschreibung. Das Objekt erbt von CalloutVariable. Name, Art und Toleranz der Variablen stehen dort.

Zugriff

Beispiel

' Gibt alle Längen der ausgewählten Bohrungsbeschreibung aus und stellt sie
' auf eine Nachkommastelle um.
' Vorbedingung: Eine Zeichnung ist offen, eine Bohrungsbeschreibung ist ausgewählt.
' Ergebnis:     Name, Wert und bisherige Nachkommastellen jeder Länge stehen im Direktfenster.
'               Die Bohrungsbeschreibung zeigt die Längen mit einer Nachkommastelle.
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 swLaenge As SldWorks.CalloutLengthVariable
    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)
        If swVar.Type = swCalloutVariableType_Length Then
            Set swLaenge = swVar                        ' dieselbe Variable als Längenvariable
            Debug.Print swVar.UserReadableVariableName & ": " & swLaenge.Length * 1000 & " mm, " & _
                        swLaenge.Precision & " Nachkommastellen"
            swLaenge.Precision = 1
        End If
    Next i

    Set swModelView = swModel.ActiveView
    swModelView.GraphicsRedraw Empty                    ' zur Sicherheit neu zeichnen
End Sub

Bemerkungen

Wert nur lesbar: Die Hilfe beschreibt CalloutLengthVariable.Length mit „Gets or sets“, deklariert die Eigenschaft aber nur lesbar. Eine Einheit nennt sie nicht. Vermutlich sind es wie sonst in der API Meter.

Doppelbemaßung: CalloutLengthVariable.Precision und CalloutLengthVariable.TolerancePrecision gelten für den Maßwert. Die Stellen des zweiten Werts und seiner Toleranz setzt du mit DisplayDimension.SetPrecision3 der Bohrungsbeschreibung.

Erben von CalloutVariable: CalloutLengthVariable, CalloutAngleVariable und CalloutStringVariable erben von CalloutVariable. Das Hilfebeispiel „Get and Set Hole Callout Variables“ prüft die Art mit CalloutVariable.Type und weist die Variable dann einer Variablen vom Typ CalloutLengthVariable zu. Die Toleranzart setzt es über die Variable vom Typ CalloutVariable.

Eigenschaften und Methoden

Eigenschaften 3, davon 3 beschrieben

NameBeschreibung
LengthLiefert den Wert der Längenvariablen in einer Bohrungsbeschreibung, etwa einen Durchmesser oder eine Tiefe.
PrecisionLiest oder setzt, wie viele Nachkommastellen die Bohrungsbeschreibung beim Maßwert der Längenvariablen anzeigt.
TolerancePrecisionLiest oder setzt, wie viele Nachkommastellen die Bohrungsbeschreibung bei der Toleranz der Längenvariablen anzeigt.

Siehe auch

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

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