Objekt · SldWorks
AttributeDef-Objekt
Die Definition eines Attributs: die Vorlage mit Parametern, aus der du Attribute an Flächen, Kanten, Features, Körpern, Komponenten oder am Dokument anlegst.
Beschreibung
Eine Attributdefinition ist die Vorlage für ein Datenpaket, das eine Anwendung im Modell ablegt. Die Definition enthält Namen, Typen und Vorgabewerte der Parameter. Aus ihr legst du die einzelnen Attribute (Attribute) mit eigenen Werten an. Die Attribute werden mit der SOLIDWORKS-Datei gespeichert und beim Öffnen wieder geladen.
Der Ablauf:
SldWorks.DefineAttribute: die Definition anlegenAttributeDef.AddParameter: Parameter hinzufügenAttributeDef.Register: die Definition registrierenAttributeDef.CreateInstance5: Attribute anlegen, so viele du willst
Ohne Beschreibung in der Hilfe sind AttributeDef.AddCallback, AttributeDef.GetOption und AttributeDef.SetOption.
Zugriff
SldWorks.DefineAttribute: legt die Definition an oder hängt sich an eine vorhandene mit demselben NamenAttribute.GetDefinition: die Definition eines vorhandenen Attributs
Beispiel
' Legt die Attributdefinition „pubPruefung“ mit zwei Parametern an und hängt ein Attribut
' an die ausgewählte Fläche.
' Vorbedingung: Ein Teil ist offen, eine Fläche ist ausgewählt.
' Ergebnis: Im FeatureManager steht ein Attribut Pruefung1 (oder Pruefung2 ...) mit Prüfer und Stand.
Option Explicit
Sub main()
Dim swApp As SldWorks.SldWorks
Dim swModel As SldWorks.ModelDoc2
Dim swSelMgr As SldWorks.SelectionMgr
Dim swFace As SldWorks.Face2
Dim swAttDef As SldWorks.AttributeDef
Dim swAtt As SldWorks.Attribute
Dim swParam As SldWorks.Parameter
Dim i As Long
Set swApp = Application.SldWorks
Set swModel = swApp.ActiveDoc
If swModel Is Nothing Then Exit Sub
Set swSelMgr = swModel.SelectionManager
If swSelMgr.GetSelectedObjectType3(1, -1) <> swSelFACES Then Exit Sub
Set swFace = swSelMgr.GetSelectedObject6(1, -1)
' Schritte 1 bis 3: Definition anlegen, Parameter hinzufügen, registrieren
Set swAttDef = swApp.DefineAttribute("pubPruefung")
swAttDef.AddParameter "Pruefer", swParamTypeString, 0#, 0
swAttDef.AddParameter "Stand", swParamTypeDouble, 1#, 0 ' Vorgabewert 1
swAttDef.Register
' Schritt 4: Attribut unter einem Namen anlegen, den es im FeatureManager noch nicht gibt
Do While swAtt Is Nothing And i < 100
i = i + 1
Set swAtt = swAttDef.CreateInstance5(swModel, swFace, "Pruefung" & i, 0, swThisConfiguration)
Loop
If swAtt Is Nothing Then Exit Sub
Set swParam = swAtt.GetParameter("Pruefer")
swParam.SetStringValue2 Environ("USERNAME"), swAllConfiguration, ""
swModel.ForceRebuild3 False ' damit der FeatureManager das Attribut zeigt
Debug.Print "Angelegt: " & swAtt.GetName
End SubBemerkungen
Einmal je Sitzung: Die Schritte 1 bis 3 machst du einmal je Sitzung. Läuft das Makro ein zweites Mal, gibt es die Definition schon. SldWorks.DefineAttribute hängt sich dann an sie an, und Parameter lassen sich nicht mehr hinzufügen oder entfernen. Die Hilfebeispiele rufen AddParameter und Register trotzdem bei jedem Lauf auf und werten das Ergebnis nicht aus. Eine Definition bleibt über die Sitzung hinaus erhalten, wenn ein Dokument ein Attribut mit ihr enthält.
Name der Definition: Der Name muss in der Sitzung eindeutig sein. Die ersten drei Buchstaben sollen eine offizielle Kennung des Herstellers sein, zum Testen „pub“. Den Namen einer vorhandenen Definition liefert die API nicht.
Attribute wiederfinden: Mit der Definition suchst du Attribute an Elementen, Körpern und Komponenten: Entity.FindAttribute, Body2.FindAttribute und Component2.FindAttribute. Attribute am Dokument findest du als Feature vom Typ Attribute im FeatureManager, siehe das Beispiel bei Attribute.
Veraltete Befehle: AttributeDef.CreateInstance bis AttributeDef.CreateInstance4 sind durch CreateInstance5 ersetzt. CreateInstance5 nimmt Körper, Komponenten und Elemente im selben Parameter.
Getestet: Das Beispiel lief in SOLIDWORKS 2024 an einem Quader mit ausgewählter Oberseite dreimal hintereinander und legte Pruefung1 bis Pruefung3 an. Beim zweiten Lauf hängte sich SldWorks.DefineAttribute an die vorhandene Definition an. AttributeDef.AddCallback brachte SOLIDWORKS zum Absturz, siehe dort.
Eigenschaften und Methoden
Methoden 10, davon 6 beschrieben, 4 veraltet
| Name | Beschreibung |
|---|---|
| AddCallback | Ohne Beschreibung in der Hilfe. Dem Namen nach meldet die Methode eine Rückruffunktion für die Attributdefinition an. |
| AddParameter | Fügt der Attributdefinition einen Parameter mit Namen, Typ und Vorgabewert hinzu. |
| CreateInstance | veraltet ersetzt durch AttributeDef.CreateInstance5 |
| CreateInstance2 | veraltet ersetzt durch AttributeDef.CreateInstance5 |
| CreateInstance3 | veraltet ersetzt durch AttributeDef.CreateInstance5 |
| CreateInstance4 | veraltet ersetzt durch AttributeDef.CreateInstance5 |
| CreateInstance5 | Legt ein Attribut dieser Definition an einem Element, Körper, an einer Komponente oder am Dokument an. |
| GetOption | Ohne Beschreibung in der Hilfe. Dem Namen nach liefert die Methode eine Einstellung der Attributdefinition. |
| Register | Registriert die Attributdefinition als letzten Schritt, bevor du Attribute anlegst. |
| SetOption | Ohne Beschreibung in der Hilfe. Dem Namen nach setzt die Methode eine Einstellung der Attributdefinition. |
Nicht aufgeführt sind 4 C++-Varianten (Namen mit I davor, zum Beispiel ICreateInstance). In VBA nimmst du immer den Befehl ohne I.
Siehe auch
Englisches Original: IAttributeDef in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.