Methode · Dimension
SetSystemValue3-Methode (Dimension)
Setzt den Wert einer Bemaßung in SI-Einheiten (Meter, Bogenmaß), unabhängig von den Einheiten des Dokuments.
Syntax
Function SetSystemValue3( _
ByVal NewValue As Double, _
ByVal WhichConfigurations As Long, _
ByVal Config_names As Variant _
) As LongnStatus = swDim.SetSystemValue3(NewValue, swSetValue_InThisConfiguration, Empty)Parameter
NewValueDoubleByVal- Der neue Wert in SI-Einheiten: Längen in Metern, Winkel im Bogenmaß. 25 mm sind
0.025. WhichConfigurationsLongByVal- Für welche Konfigurationen, ein Wert aus
swSetValueInConfiguration_e, meistswSetValue_InThisConfiguration(1). Config_namesVariantByVal- Nur bei
swSetValue_InSpecificConfigurations: der Name einer Konfiguration oder ein Array mit Namen. SonstEmpty.
Rückgabewert
Ein Status aus swSetValueReturnStatus_e, swSetValue_Successful (0), wenn es geklappt hat.
Beispiel
' Setzt D1@Skizze1 auf 25 mm, egal welche Einheit das Dokument verwendet.
' Vorbedingung: Ein Teil mit der Längenbemaßung D1@Skizze1 ist geöffnet.
' Ergebnis: D1 ist 25 mm, das Teil ist neu aufgebaut.
Option Explicit
Sub main()
Dim swApp As SldWorks.SldWorks
Dim swModel As SldWorks.ModelDoc2
Dim swDim As SldWorks.Dimension
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
If swDim.SetSystemValue3(25 / 1000, swSetValue_InThisConfiguration, Empty) = swSetValue_Successful Then
swModel.EditRebuild3
End If
End SubBemerkungen
Mit SetSystemValue3 hängt das Makro nicht davon ab, ob das Dokument in Millimetern, Zentimetern oder Zoll eingestellt ist. Rechne einfach selbst in Meter um, wie im Beispiel mit / 1000.
SetSystemValue3 ändert auch schreibgeschützte Bemaßungen. Ob eine Bemaßung schreibgeschützt ist, sagt Dimension.ReadOnly. Hat das Teil nur eine Konfiguration, ignoriert SOLIDWORKS den Parameter WhichConfigurations.
Der Vorgänger SetSystemValue2 ist veraltet.
Siehe auch
Verfügbarkeit
SOLIDWORKS 2004
Englisches Original: IDimension::SetSystemValue3 in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.