Enumeration · SwConst
swSetValueReturnStatus_e-Enumeration
Ergebnis beim Setzen eines Bemaßungswerts mit SetValue3, SetSystemValue3 oder SetUserValueIn2: Erfolg oder der Grund für den Fehler.
Syntax
Enum swSetValueReturnStatus_e
swSetValue_Successful = 0
swSetValue_Failure = 1
swSetValue_InvalidValue = 2
swSetValue_DrivenDimension = 3
swSetValue_ModelNotLoaded = 4
swSetValue_FrozenFeatureOwner = 5
End EnumWerte
| Konstante | Wert | Bedeutung |
|---|---|---|
swSetValue_Successful | 0 | Erfolg, der neue Wert ist gesetzt. |
swSetValue_Failure | 1 | Fehlgeschlagen, aus unbekanntem Grund. |
swSetValue_InvalidValue | 2 | Der neue Wert ist für diese Bemaßung nicht zulässig. |
swSetValue_DrivenDimension | 3 | Die 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_ModelNotLoaded | 4 | Das Modell der Bemaßung ist nicht geladen. Es muss geladen sein, damit sich der Wert setzen lässt. |
swSetValue_FrozenFeatureOwner | 5 | Das 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 SelectBemerkungen
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.