SolidWorksMakroprogrammierung

Enumeration · SwConst

swSetValueReturnStatus_e-Enumeration

Ergebnis beim Setzen eines Bemaßungswerts mit SetValue3, SetSystemValue3 oder SetUserValueIn2: Erfolg oder der Grund für den Fehler.

Bibliothek SwConst · 6 Werte · im Code direkt mit Namen verwendbar, zum Beispiel swSetValue_Successful

Syntax

Enum swSetValueReturnStatus_e
    swSetValue_Successful         = 0
    swSetValue_Failure            = 1
    swSetValue_InvalidValue       = 2
    swSetValue_DrivenDimension    = 3
    swSetValue_ModelNotLoaded     = 4
    swSetValue_FrozenFeatureOwner = 5
End Enum

Werte

KonstanteWertBedeutung
swSetValue_Successful0Erfolg, der neue Wert ist gesetzt.
swSetValue_Failure1Fehlgeschlagen, aus unbekanntem Grund.
swSetValue_InvalidValue2Der neue Wert ist für diese Bemaßung nicht zulässig.
swSetValue_DrivenDimension3Die Bemaßung ist getrieben: SOLIDWORKS berechnet sie aus der Geometrie, sie lässt sich deshalb nicht setzen. Ob eine Bemaßung getrieben ist, sagt dir vorher Dimension.DrivenState.
swSetValue_ModelNotLoaded4Das Modell der Bemaßung ist nicht geladen. Es muss geladen sein, damit sich der Wert setzen lässt.
swSetValue_FrozenFeatureOwner5Das Feature, zu dem die Bemaßung gehört, ist eingefroren, liegt also oberhalb der Einfrieren-Leiste. Prüfen kannst du das mit Feature.IsFrozen.

Beispiel

' swDim ist eine Dimension, etwa aus ModelDoc2.Parameter("D1@Skizze1").
' swModel ist das aktive Dokument (ModelDoc2).
Dim nStatus As Long
nStatus = swDim.SetSystemValue3(0.025, swSetValue_InThisConfiguration, Empty)   ' 25 mm
Select Case nStatus
    Case swSetValue_Successful: swModel.EditRebuild3
    Case swSetValue_DrivenDimension: Debug.Print "Getriebene Bemaßung, nicht änderbar"
    Case swSetValue_FrozenFeatureOwner: Debug.Print "Feature ist eingefroren"
    Case swSetValue_InvalidValue: Debug.Print "Wert nicht zulässig"
    Case Else: Debug.Print "Nicht gesetzt, Status " & nStatus
End Select

Bemerkungen

Die Werte liefern Dimension.SetValue3, Dimension.SetSystemValue3 und Dimension.SetUserValueIn2 als Rückgabewert. Prüf auf Erfolg immer mit dem Namen swSetValue_Successful. Im Modell siehst du den neuen Wert erst nach einem Neuaufbau, etwa mit ModelDoc2.EditRebuild3.

Für welche Konfigurationen der Wert gilt, wählst du beim Aufruf mit einem Wert aus swSetValueInConfiguration_e. Dessen Werte beginnen ebenfalls mit swSetValue_, etwa swSetValue_InThisConfiguration. Verwechsle die beiden Enumerationen nicht.

SetSystemValue3 und SetUserValueIn2 ändern auch schreibgeschützte Bemaßungen (Dimension.ReadOnly). Einen eigenen Status für schreibgeschützte Bemaßungen gibt es nicht. Für SetValue3 sagt die Hilfe dazu nichts.

Verwendet von

Siehe auch

In den Videos

Englisches Original: swSetValueReturnStatus_e in der SOLIDWORKS API-Hilfe ↗

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