SolidWorksMakroprogrammierung

Methode · AttributeDef

AddParameter-Methode (AttributeDef)

Fügt der Attributdefinition einen Parameter mit Namen, Typ und Vorgabewert hinzu.

Syntax

Function AddParameter( _
   ByVal NameIn As String, _
   ByVal Type As Long, _
   ByVal DefaultValue As Double, _
   ByVal Options As Long _
) As Boolean
bErfolg = swAttDef.AddParameter("Pruefer", swParamTypeString, 0#, 0)

Parameter

NameInStringByVal
Name des Parameters. Er muss in der Definition eindeutig sein.
TypeLongByVal
Typ als Wert aus swParamType_e, etwa swParamTypeDouble oder swParamTypeString.
DefaultValueDoubleByVal
Vorgabewert. Er gilt nur für swParamTypeDouble: Neue Attribute bekommen diesen Wert.
OptionsLongByVal
Nicht verwendet, übergib 0.

Rückgabewert

True, wenn der Parameter hinzugefügt wurde, sonst False.

Beispiel

' swAttDef ist eine neue Attributdefinition (AttributeDef), etwa aus SldWorks.DefineAttribute.
If False = swAttDef.AddParameter("Pruefer", swParamTypeString, 0#, 0) Then Debug.Print "Pruefer nicht angelegt"
If False = swAttDef.AddParameter("Toleranz", swParamTypeDouble, 0.1, 0) Then Debug.Print "Toleranz nicht angelegt"
If False = swAttDef.AddParameter("Anzahl", swParamTypeInteger, 0#, 0) Then Debug.Print "Anzahl nicht angelegt"
swAttDef.Register                                   ' danach keine weiteren Parameter

Bemerkungen

Du kannst Parameter nur hinzufügen, bevor die Definition mit AttributeDef.Register registriert ist. Gibt es die Definition schon in der Sitzung, etwa weil das Makro zum zweiten Mal läuft, hängt sich SldWorks.DefineAttribute an sie an. Dann lassen sich keine Parameter mehr hinzufügen oder entfernen.

Für ganze Zahlen gibt es keine eigenen Befehle zum Lesen und Schreiben. Du nimmst Parameter.GetDoubleValue und Parameter.SetDoubleValue2. Negative ganze Zahlen erlaubt SOLIDWORKS nach Angabe der Hilfe nicht. In SOLIDWORKS 2024 nimmt ein ganzzahliger Parameter aber -2 an und liefert es zurück. 2,7 wird zu 2 abgeschnitten. Brauchst du negative Werte, nimm swParamTypeDouble.

Die Werte eines Attributs liest und schreibst du später über Attribute.GetParameter mit dem Namen aus NameIn.

AddParameter liefert True, auch bei einem doppelten Namen und nach AttributeDef.Register; ob der Parameter wirklich angelegt ist, siehst du erst am fertigen Attribut mit Attribute.GetParameter. Früh gebunden kommt True als 1, prüf deshalb nicht mit If Not …, sondern mit If … = False.

Siehe auch

Verfügbarkeit

In allen aktuellen Versionen vorhanden. Seit wann es den Befehl gibt, nennt die Hilfe nicht.

Englisches Original: IAttributeDef::AddParameter in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)

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