SolidWorksMakroprogrammierung

Objekt · SldWorks

Dimension-Objekt

Steht für eine Bemaßung im Modell: ihren Namen und ihren Wert, auch je Konfiguration.

Deklaration Dim x As SldWorks.Dimension · in der englischen .NET-Hilfe: IDimension

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

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 Sub

Bemerkungen

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

NameBeschreibung
DimensionLineDirectionLiefert oder setzt die Richtung der Maßlinie einer Feature-Bemaßung.
DrivenStateLiefert oder setzt, ob eine Bemaßung die Geometrie steuert oder von ihr bestimmt wird.
ExtensionLineDirectionLiefert oder setzt die Richtung der Maßhilfslinien einer Feature-Bemaßung.
FullNameLiefert den vollständigen Namen einer Bemaßung mit Feature und Modell, zum Beispiel "D1@Skizze1@Welle.Part".
NameLiefert oder ändert den kurzen Namen einer Bemaßung, etwa „D1“.
ReadOnlyLiefert oder setzt, ob eine Bemaßung schreibgeschützt ist.
ReferencePointsLiefert oder setzt die drei Bezugspunkte einer Bemaßung als MathPoint-Objekte.
SystemValueveraltet ersetzt durch Dimension.GetSystemValue3 und Dimension.SetSystemValue3
ToleranceLiefert die Toleranz einer Bemaßung als DimensionTolerance-Objekt.
Valueveraltet ersetzt durch Dimension.GetValue3 und Dimension.SetValue3

Methoden 29, davon 16 beschrieben, 13 veraltet

NameBeschreibung
GetArcEndConditionLiefert, wo eine Längenbemaßung an einem Bogen ansetzt: Mitte, nächster oder fernster Punkt.
GetFeatureOwnerLiefert das Feature, zu dem eine Bemaßung gehört.
GetNameForSelectionLiefert den Namen einer Bemaßung so, wie SelectByID2 ihn erwartet.
GetReferencePointsCountLiefert die Anzahl der Bezugspunkte einer Bemaßung.
GetSystemChamferValuesLiefert Länge und Winkel einer Fasenbemaßung in Metern und im Bogenmaß.
GetSystemValue2veraltet ersetzt durch Dimension.GetSystemValue3
GetSystemValue3Liefert den Wert einer Bemaßung in SI-Einheiten (Meter, Bogenmaß), unabhängig von den Einheiten des Dokuments.
GetToleranceFitValuesveraltet ersetzt durch DimensionTolerance.GetHoleFitValue und DimensionTolerance.GetShaftFitValue
GetToleranceFontInfoveraltet ersetzt durch DimensionTolerance.GetFontUseDimension, DimensionTolerance.GetFontUseScale, DimensionTolerance.GetFontScale und DimensionTolerance.GetFontHeight
GetToleranceTypeveraltet ersetzt durch DimensionTolerance.Type
GetToleranceValuesveraltet ersetzt durch DimensionTolerance.GetMaxValue2 und DimensionTolerance.GetMinValue2
GetTypeLiefert die Art einer Bemaßung: Länge, Winkel oder ganze Zahl.
GetUserValueInLiefert den Wert einer Bemaßung in den Einheiten eines bestimmten Dokuments.
GetValue2veraltet ersetzt durch Dimension.GetValue3
GetValue3Liefert den Wert einer Bemaßung in der Einheit des Dokuments, für eine, mehrere oder alle Konfigurationen.
IsAppliedToAllConfigurationsLiefert, ob der Wert einer Bemaßung in allen Konfigurationen gilt oder nur in der aktiven.
IsDesignTableDimensionLiefert, ob eine Bemaßung von einer Konstruktionstabelle gesteuert wird.
IsReferenceLiefert, ob eine Bemaßung eine Referenzbemaßung ist.
SetArcEndConditionLegt fest, wo eine Längenbemaßung an einem Bogen ansetzt: Mitte, nächster oder fernster Punkt.
SetSystemValue2veraltet ersetzt durch Dimension.SetSystemValue3
SetSystemValue3Setzt den Wert einer Bemaßung in SI-Einheiten (Meter, Bogenmaß), unabhängig von den Einheiten des Dokuments.
SetToleranceFitValuesveraltet ersetzt durch DimensionTolerance.SetFitValues
SetToleranceFontInfoveraltet ersetzt durch DimensionTolerance.SetFont
SetToleranceTypeveraltet ersetzt durch DimensionTolerance.Type
SetToleranceValuesveraltet ersetzt durch DimensionTolerance.SetValues2
SetUserValueInveraltet ersetzt durch Dimension.SetUserValueIn2
SetUserValueIn2Setzt den Wert einer Bemaßung in den Einheiten eines bestimmten Dokuments.
SetValue2veraltet ersetzt durch Dimension.SetValue3
SetValue3Setzt 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.