SolidWorksMakroprogrammierung

Enumeration · SwConst

swCustomPropertyAddOption_e-Enumeration

Was CustomPropertyManager.Add3 tut, wenn es die Eigenschaft schon gibt: nichts, ersetzen oder neu anlegen.

Bibliothek SwConst · 3 Werte · im Code direkt mit Namen verwendbar, zum Beispiel swCustomPropertyOnlyIfNew

Syntax

Enum swCustomPropertyAddOption_e
    swCustomPropertyOnlyIfNew    = 0
    swCustomPropertyDeleteAndAdd = 1
    swCustomPropertyReplaceValue = 2
End Enum

Werte

KonstanteWertBedeutung
swCustomPropertyOnlyIfNew0Nur anlegen, wenn es die Eigenschaft noch nicht gibt. Eine vorhandene bleibt unverändert. Gut für Vorgabewerte, die Einträge des Benutzers nicht überschreiben sollen.
swCustomPropertyDeleteAndAdd1Eine vorhandene Eigenschaft löschen und neu anlegen. Damit lässt sich auch der Typ ändern.
swCustomPropertyReplaceValue2Bei einer vorhandenen Eigenschaft nur den Wert ersetzen, sonst neu anlegen. Für die meisten Makros die richtige Wahl.

Beispiel

' Setzt "Werkstoff" auf "S235JR", aber nur, wenn noch nichts eingetragen ist.
' Vorbedingung: Ein Dokument ist geöffnet.
' Ergebnis:     "Werkstoff" ist vorhanden. Ein vorhandener Eintrag bleibt unverändert.
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Then Exit Sub

    swModel.Extension.CustomPropertyManager("").Add3 "Werkstoff", swCustomInfoText, "S235JR", swCustomPropertyOnlyIfNew
    swModel.SetSaveFlag
End Sub

Bemerkungen

Der Unterschied zwischen swCustomPropertyReplaceValue und swCustomPropertyDeleteAndAdd zeigt sich beim Typ: ReplaceValue behält den Typ der vorhandenen Eigenschaft, DeleteAndAdd legt sie mit dem neuen Typ an. Passt bei ReplaceValue der neue Wert nicht zum alten Typ, meldet CustomPropertyManager.Add3 einen Fehler.

Nur einen vorhandenen Wert ändern, ohne je etwas anzulegen, kann CustomPropertyManager.Set2.

Verwendet von

Siehe auch

In den Videos

Englisches Original: swCustomPropertyAddOption_e in der SOLIDWORKS API-Hilfe ↗

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