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 BooleanbErfolg = 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, etwaswParamTypeDoubleoderswParamTypeString. 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 ParameterBemerkungen
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.