SolidWorksMakroprogrammierung

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 Long
nStatus = 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, meist swSetValue_InThisConfiguration (1).
Config_namesVariantByVal
Nur bei swSetValue_InSpecificConfigurations: der Name einer Konfiguration oder ein Array mit Namen. Sonst Empty.

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 Sub

Bemerkungen

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.