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 VariantvWerte = swDim.GetSystemValue3(swThisConfiguration, Empty)Parameter
WhichConfigurationsLongByVal- Für welche Konfigurationen, ein Wert aus
swInConfigurationOpts_e, meistswThisConfiguration(1) für die aktive. Config_namesVariantByVal- Nur bei
swSpecifyConfiguration: der Name einer Konfiguration oder ein Array mit Namen. SonstEmpty.
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 SubBemerkungen
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.