SolidWorksMakroprogrammierung

Methode · Attribute

GetEntityState-Methode (Attribute)

Prüft, ob das Element eines Attributs ungültig, unterdrückt, mehrdeutig oder gelöscht ist.

Syntax

Function GetEntityState( _
   ByVal WhichState As Long _
) As Boolean
bUnterdrueckt = swAtt.GetEntityState(swIsEntitySuppressed)

Parameter

WhichStateLongByVal
Der abgefragte Zustand, ein Wert aus swAssociatedEntityStates_e: swIsEntityInvalid (0) ungültig, swIsEntitySuppressed (1) unterdrückt, swIsEntityAmbiguous (2) mehrdeutig, swIsEntityDeleted (3) gelöscht.

Rückgabewert

True, wenn der abgefragte Zustand zutrifft.

Beispiel

' swAtt ist ein Attribute, etwa aus Entity.FindAttribute.
If swAtt.GetEntityState(swIsEntitySuppressed) Then
    Debug.Print "Element ist unterdrückt."
ElseIf swAtt.GetEntityState(swIsEntityInvalid) Then
    Debug.Print "Element ist ungültig, etwa durch eine Modelländerung."
ElseIf swAtt.GetEntityState(swIsEntityAmbiguous) Or swAtt.GetEntityState(swIsEntityDeleted) Then
    Debug.Print "Element ist mehrdeutig oder gelöscht."
Else
    Debug.Print "Element ist in Ordnung."
End If

Bemerkungen

swIsEntityInvalid ist die allgemeine Abfrage: True, wenn das Element durch Unterdrücken oder eine Modelländerung nicht mehr gültig ist. swIsEntitySuppressed ist genauer und liefert nur dann True, wenn der Grund das Unterdrücken ist. Hängt das Attribut am Dokument und nicht an einem Element, liefern alle Abfragen False.

Beispiel aus der Hilfe: Ein Attribut sitzt an einer Fläche eines Aufsatzes, und der Aufsatz wird unterdrückt. Dann liefert Attribute.GetEntity Nothing, und beide Abfragen swIsEntityInvalid und swIsEntitySuppressed liefern True. Was „mehrdeutig“ und „gelöscht“ genau bedeuten, beschreibt die Hilfe nicht.

Nach dem Unterdrücken des Features liefert bei einem Attribut an einer Fläche auch swIsEntityAmbiguous den Wert True. Hebst du die Unterdrückung wieder auf, bleibt das Attribut ungültig und mehrdeutig, auch nach einem Neuaufbau; es findet seine Fläche nicht wieder.

Siehe auch

Verfügbarkeit

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

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

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