Objekt · SldWorks
Dimension-Objekt
Steht für eine Bemaßung im Modell: ihren Namen und ihren Wert, auch je Konfiguration.
Beschreibung
Ein Dimension-Objekt ist die Bemaßung selbst, also Name und Wert. Wie sie im Modell oder in der Zeichnung aussieht, Position, Text, Pfeile, regelt ein anderes Objekt, die DisplayDimension.
Zugriff
ModelDoc2.Parametermit dem Namen der Bemaßung und des Features, etwa"D1@Skizze1"Feature.Parametermit dem kurzen Namen, etwa"D1"DisplayDimension.GetDimension2mit0, wenn du die angezeigte Bemaßung schon hast, zum Beispiel aus der Auswahl
Beispiel
' Zeigt vollständigen Namen, Wert in Dokument-Einheiten und Wert in Metern.
' Vorbedingung: Ein Teil mit der Bemaßung D1@Skizze1 ist geöffnet.
' Ergebnis: Meldung mit den drei Angaben.
Option Explicit
Sub main()
Dim swApp As SldWorks.SldWorks
Dim swModel As SldWorks.ModelDoc2
Dim swDim As SldWorks.Dimension
Dim vWert As Variant
Dim vSystem As Variant
Set swApp = Application.SldWorks
Set swModel = swApp.ActiveDoc
If swModel Is Nothing Then Exit Sub
Set swDim = swModel.Parameter("D1@Skizze1")
If swDim Is Nothing Then Exit Sub
vWert = swDim.GetValue3(swThisConfiguration, Empty)
vSystem = swDim.GetSystemValue3(swThisConfiguration, Empty)
swApp.SendMsgToUser2 swDim.FullName & vbCrLf & _
"Wert: " & vWert(0) & vbCrLf & _
"In Metern: " & vSystem(0), swMbInformation, swMbOk
End SubBemerkungen
Für den Wert gibt es zwei Paare von Befehlen. GetValue3 liefert ihn in der Einheit des Dokuments, so wie SOLIDWORKS ihn anzeigt. GetSystemValue3 liefert ihn in SI-Einheiten, unabhängig von den Einstellungen des Dokuments. Für Berechnungen im Makro ist GetSystemValue3 sicherer, für Meldungen an den Benutzer GetValue3.
Alle vier Befehle arbeiten mit Konfigurationen. Der Parameter WhichConfigurations sagt, für welche. Für die aktive Konfiguration ist das beim Lesen swThisConfiguration, beim Setzen swSetValue_InThisConfiguration.
Nach dem Ändern eines Werts muss das Modell neu aufgebaut werden, etwa mit ModelDoc2.EditRebuild3. Die älteren Eigenschaften Value und SystemValue sind veraltet.
Eigenschaften und Methoden
Eigenschaften 10, davon 8 beschrieben, 2 veraltet
| Name | Beschreibung |
|---|---|
| DimensionLineDirection | Liefert oder setzt die Richtung der Maßlinie einer Feature-Bemaßung. |
| DrivenState | Liefert oder setzt, ob eine Bemaßung die Geometrie steuert oder von ihr bestimmt wird. |
| ExtensionLineDirection | Liefert oder setzt die Richtung der Maßhilfslinien einer Feature-Bemaßung. |
| FullName | Liefert den vollständigen Namen einer Bemaßung mit Feature und Modell, zum Beispiel "D1@Skizze1@Welle.Part". |
| Name | Liefert oder ändert den kurzen Namen einer Bemaßung, etwa „D1“. |
| ReadOnly | Liefert oder setzt, ob eine Bemaßung schreibgeschützt ist. |
| ReferencePoints | Liefert oder setzt die drei Bezugspunkte einer Bemaßung als MathPoint-Objekte. |
| SystemValue | veraltet ersetzt durch Dimension.GetSystemValue3 und Dimension.SetSystemValue3 |
| Tolerance | Liefert die Toleranz einer Bemaßung als DimensionTolerance-Objekt. |
| Value | veraltet ersetzt durch Dimension.GetValue3 und Dimension.SetValue3 |
Methoden 29, davon 16 beschrieben, 13 veraltet
| Name | Beschreibung |
|---|---|
| GetArcEndCondition | Liefert, wo eine Längenbemaßung an einem Bogen ansetzt: Mitte, nächster oder fernster Punkt. |
| GetFeatureOwner | Liefert das Feature, zu dem eine Bemaßung gehört. |
| GetNameForSelection | Liefert den Namen einer Bemaßung so, wie SelectByID2 ihn erwartet. |
| GetReferencePointsCount | Liefert die Anzahl der Bezugspunkte einer Bemaßung. |
| GetSystemChamferValues | Liefert Länge und Winkel einer Fasenbemaßung in Metern und im Bogenmaß. |
| GetSystemValue2 | veraltet ersetzt durch Dimension.GetSystemValue3 |
| GetSystemValue3 | Liefert den Wert einer Bemaßung in SI-Einheiten (Meter, Bogenmaß), unabhängig von den Einheiten des Dokuments. |
| GetToleranceFitValues | veraltet ersetzt durch DimensionTolerance.GetHoleFitValue und DimensionTolerance.GetShaftFitValue |
| GetToleranceFontInfo | veraltet ersetzt durch DimensionTolerance.GetFontUseDimension, DimensionTolerance.GetFontUseScale, DimensionTolerance.GetFontScale und DimensionTolerance.GetFontHeight |
| GetToleranceType | veraltet ersetzt durch DimensionTolerance.Type |
| GetToleranceValues | veraltet ersetzt durch DimensionTolerance.GetMaxValue2 und DimensionTolerance.GetMinValue2 |
| GetType | Liefert die Art einer Bemaßung: Länge, Winkel oder ganze Zahl. |
| GetUserValueIn | Liefert den Wert einer Bemaßung in den Einheiten eines bestimmten Dokuments. |
| GetValue2 | veraltet ersetzt durch Dimension.GetValue3 |
| GetValue3 | Liefert den Wert einer Bemaßung in der Einheit des Dokuments, für eine, mehrere oder alle Konfigurationen. |
| IsAppliedToAllConfigurations | Liefert, ob der Wert einer Bemaßung in allen Konfigurationen gilt oder nur in der aktiven. |
| IsDesignTableDimension | Liefert, ob eine Bemaßung von einer Konstruktionstabelle gesteuert wird. |
| IsReference | Liefert, ob eine Bemaßung eine Referenzbemaßung ist. |
| SetArcEndCondition | Legt fest, wo eine Längenbemaßung an einem Bogen ansetzt: Mitte, nächster oder fernster Punkt. |
| SetSystemValue2 | veraltet ersetzt durch Dimension.SetSystemValue3 |
| SetSystemValue3 | Setzt den Wert einer Bemaßung in SI-Einheiten (Meter, Bogenmaß), unabhängig von den Einheiten des Dokuments. |
| SetToleranceFitValues | veraltet ersetzt durch DimensionTolerance.SetFitValues |
| SetToleranceFontInfo | veraltet ersetzt durch DimensionTolerance.SetFont |
| SetToleranceType | veraltet ersetzt durch DimensionTolerance.Type |
| SetToleranceValues | veraltet ersetzt durch DimensionTolerance.SetValues2 |
| SetUserValueIn | veraltet ersetzt durch Dimension.SetUserValueIn2 |
| SetUserValueIn2 | Setzt den Wert einer Bemaßung in den Einheiten eines bestimmten Dokuments. |
| SetValue2 | veraltet ersetzt durch Dimension.SetValue3 |
| SetValue3 | Setzt den Wert einer Bemaßung in der Einheit des Dokuments, für eine, mehrere oder alle Konfigurationen. |
Nicht aufgeführt sind 13 C++-Varianten (Namen mit I davor, zum Beispiel IGetReferencePoints). In VBA nimmst du immer den Befehl ohne I.
Siehe auch
Englisches Original: IDimension in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.