SolidWorksMakroprogrammierung

Methode · AttributeDef

CreateInstance5-Methode (AttributeDef)

Legt ein Attribut dieser Definition an einem Element, Körper, an einer Komponente oder am Dokument an.

Syntax

Function CreateInstance5( _
   ByVal OwnerDoc As ModelDoc2, _
   ByVal OwnerObj As Object, _
   ByVal NameIn As String, _
   ByVal Options As Long, _
   ByVal ConfigurationOption As Long _
) As Attribute
Set swAtt = swAttDef.CreateInstance5(swModel, swFace, "Pruefung1", 0, swThisConfiguration)

Parameter

OwnerDocModelDoc2ByVal
Das Dokument, in dessen FeatureManager das Attribut kommt.
OwnerObjObjectByVal
Woran das Attribut hängt: ein Körper (Body2), eine Komponente (Component2) oder ein Element (Entity), also eine Fläche, Schleife, Kante, Ecke oder ein Feature. Mit Nothing hängt es am Dokument.
NameInStringByVal
Name des Attributs. Er muss im FeatureManager des Dokuments eindeutig sein.
OptionsLongByVal
Bit 1: 1 legt das Attribut im FeatureManager versteckt an, 0 sichtbar.
ConfigurationOptionLongByVal
Für welche Konfigurationen, ein Wert aus swInConfigurationOpts_e.

Rückgabewert

Das neue Attribut (Attribute). Die Hilfebeispiele werten Nothing so, dass der Name schon vergeben ist, und probieren den nächsten.

Beispiel

' swModel ist ein Teil (ModelDoc2), swAttDef eine registrierte Attributdefinition (AttributeDef).
Dim swAtt As SldWorks.Attribute
Dim i As Long
Do While swAtt Is Nothing And i < 100
    i = i + 1
    Set swAtt = swAttDef.CreateInstance5(swModel, Nothing, "Auftrag" & i, 1, swAllConfiguration)   ' 1 = versteckt
Loop
If Not swAtt Is Nothing Then Debug.Print "Angelegt: " & swAtt.GetName

Bemerkungen

Ein Attribut ist ein Feature: Deshalb muss sein Name im FeatureManager eindeutig sein. Hängt es an einem Feature, zeigt der FeatureManager es unter Umständen erst nach einem Neuaufbau, etwa mit ModelDoc2.ForceRebuild3. Legst du viele Attribute an, baust du am besten einmal am Ende neu auf. Sichtbar oder versteckt machst du es später mit Feature.SetUIState.

Konfigurationen: SOLIDWORKS fügt ein Attribut standardmäßig nur der aktiven Konfiguration hinzu, in allen anderen steht es als unterdrücktes Feature. Dort aktivierst du es, indem du es mit ModelDocExtension.SelectByID2 auswählst und ModelDoc2.EditUnsuppressDependent2 aufrufst. Die Methode beachtet die Einstellung Configuration.SuppressNewFeatures. Wie sich das mit ConfigurationOption verträgt, sagt die Hilfe nicht. In SOLIDWORKS 2024 ist auch ein mit swAllConfiguration angelegtes Attribut in der anderen Konfiguration unterdrückt.

Körper in Baugruppen: Die Methode nimmst du nicht für Körper einer Baugruppe. Dafür gibt es Face2.SetFaceId und Face2.GetFaceId.

Bibliotheks-Features: Exportierst du ein Element mit Attribut in ein Bibliotheks-Feature, entfernt SOLIDWORKS das Attribut. Wann ein Attribut doch mitgeht, steht bei Attribute.IncludeInLibraryFeature.

Ersetzt die veralteten AttributeDef.CreateInstance bis AttributeDef.CreateInstance4.

Ein zweites Attribut mit einem schon vergebenen Namen liefert Nothing. Ein versteckt angelegtes Attribut (Options = 1) fehlt im FeatureManager, ein Makro findet es beim Durchgehen der Features aber trotzdem (Feature.GetUIState mit swIsHiddenInFeatureMgr liefert True).

Siehe auch

Verfügbarkeit

SOLIDWORKS 2003 SP01

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

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