Objekt · SldWorks
CalloutVariable-Objekt
Eine Variable in einer Bohrungsbeschreibung, etwa ein Durchmesser oder eine Tiefe: Name, Art, Toleranz und Passung.
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
DisplayDimension.GetHoleCalloutVariables: alle Variablen einer Bohrungsbeschreibung
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 SubBemerkungen
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
| Name | Beschreibung |
|---|---|
| FitDisplayStyle | Liest oder setzt, wie die Passung in der Bohrungsbeschreibung angezeigt wird, etwa übereinander oder in einer Zeile. |
| FitTextHeight | Liest oder setzt die Schrifthöhe der Passung in der Bohrungsbeschreibung. |
| FitTextScale | Liest oder setzt den Faktor, mit dem die Schrift der Passung in der Bohrungsbeschreibung skaliert wird. |
| FitType | Liest oder setzt die Art der Passung in der Bohrungsbeschreibung, etwa Spiel- oder Übergangspassung. |
| FitUseTextScale | Liest oder setzt, ob die Schrift der Passung mit dem Faktor aus FitTextScale skaliert wird. |
| HoleFit | Liest oder setzt die Passung der Bohrung in der Bohrungsbeschreibung. |
| ShaftFit | Liest oder setzt die Passung der Welle in der Bohrungsbeschreibung. |
| ShowParenthesis | Liest oder setzt, ob die Toleranz in der Bohrungsbeschreibung in Klammern steht. |
| TextHeight | Liest oder setzt die Schrifthöhe der Toleranz in der Bohrungsbeschreibung. |
| TextScale | Liest oder setzt den Faktor, mit dem die Schrift der Toleranz in der Bohrungsbeschreibung skaliert wird. |
| ToleranceMax | Liest oder setzt den oberen Toleranzwert der Bohrungsbeschreibung. |
| ToleranceMin | Liest oder setzt den unteren Toleranzwert der Bohrungsbeschreibung. |
| ToleranceType | Liest oder setzt die Toleranzart der Bohrungsbeschreibung, etwa zweiseitig, symmetrisch oder Passung. |
| Type | Liefert die allgemeine Art der Variablen: Länge, Winkel oder Text. |
| UserReadableVariableName | Liefert den Namen der Variablen, wie er im PropertyManager der Bemaßung in der Liste „Callout value“ steht. |
| UseTextScale | Liest oder setzt, ob die Schrift der Toleranz mit dem Faktor aus TextScale skaliert wird. |
| VariableName | Liefert den Namen der Variablen, wie er im PropertyManager der Bemaßung im Textfeld für den Bemaßungstext steht. |
| VariableType | Liefert, 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.