SolidWorksMakroprogrammierung

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.

Deklaration Dim x As SldWorks.AttributeDef · in der englischen .NET-Hilfe: IAttributeDef

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:

  1. SldWorks.DefineAttribute: die Definition anlegen
  2. AttributeDef.AddParameter: Parameter hinzufügen
  3. AttributeDef.Register: die Definition registrieren
  4. AttributeDef.CreateInstance5: Attribute anlegen, so viele du willst

Ohne Beschreibung in der Hilfe sind AttributeDef.AddCallback, AttributeDef.GetOption und AttributeDef.SetOption.

Zugriff

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 Sub

Bemerkungen

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

NameBeschreibung
AddCallbackOhne Beschreibung in der Hilfe. Dem Namen nach meldet die Methode eine Rückruffunktion für die Attributdefinition an.
AddParameterFügt der Attributdefinition einen Parameter mit Namen, Typ und Vorgabewert hinzu.
CreateInstanceveraltet ersetzt durch AttributeDef.CreateInstance5
CreateInstance2veraltet ersetzt durch AttributeDef.CreateInstance5
CreateInstance3veraltet ersetzt durch AttributeDef.CreateInstance5
CreateInstance4veraltet ersetzt durch AttributeDef.CreateInstance5
CreateInstance5Legt ein Attribut dieser Definition an einem Element, Körper, an einer Komponente oder am Dokument an.
GetOptionOhne Beschreibung in der Hilfe. Dem Namen nach liefert die Methode eine Einstellung der Attributdefinition.
RegisterRegistriert die Attributdefinition als letzten Schritt, bevor du Attribute anlegst.
SetOptionOhne 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.