SolidWorksMakroprogrammierung

Methode · Dimension

GetSystemValue3-Methode (Dimension)

Liefert den Wert einer Bemaßung in SI-Einheiten (Meter, Bogenmaß), unabhängig von den Einheiten des Dokuments.

Syntax

Function GetSystemValue3( _
   ByVal WhichConfigurations As Long, _
   ByVal Config_names As Variant _
) As Variant
vWerte = swDim.GetSystemValue3(swThisConfiguration, Empty)

Parameter

WhichConfigurationsLongByVal
Für welche Konfigurationen, ein Wert aus swInConfigurationOpts_e, meist swThisConfiguration (1) für die aktive.
Config_namesVariantByVal
Nur bei swSpecifyConfiguration: der Name einer Konfiguration oder ein Array mit Namen. Sonst Empty.

Rückgabewert

Ein Array mit den Werten in SI-Einheiten, einer pro Konfiguration: Längen in Metern, Winkel im Bogenmaß.

Beispiel

' Liest D1@Skizze1 in Metern und zeigt den Wert in Millimetern,
' unabhängig davon, ob das Dokument in mm, cm oder Zoll eingestellt ist.
' Vorbedingung: Ein Teil mit der Längenbemaßung D1@Skizze1 ist geöffnet.
' Ergebnis:     Meldung mit dem Wert in mm.
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swDim As SldWorks.Dimension
    Dim vWerte 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

    vWerte = swDim.GetSystemValue3(swThisConfiguration, Empty)
    swApp.SendMsgToUser2 "D1 = " & Format(vWerte(0) * 1000, "0.00") & " mm", swMbInformation, swMbOk
End Sub

Bemerkungen

Für Berechnungen im Makro ist GetSystemValue3 die sichere Wahl: Das Ergebnis ist immer in Metern bzw. Bogenmaß, egal wie das Dokument eingestellt ist. Dimension.GetValue3 dagegen liefert den Wert in der Einheit des Dokuments, und die kann sich ändern.

Winkel kommen im Bogenmaß. In Grad umrechnen: dGrad = vWerte(0) * 180 / 3.14159265358979.

Die Vorgänger GetSystemValue2 und die Eigenschaft SystemValue sind veraltet.

Siehe auch

Verfügbarkeit

SOLIDWORKS 2004

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

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