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 BooleanbUnterdrueckt = 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 IfBemerkungen
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.