SolidWorksMakroprogrammierung

Methode · Annotation

GetAttachedEntities3-Methode (Annotation)

Liefert die Elemente, an denen eine Beschriftung hängt, etwa Flächen, Kanten oder Skizzenpunkte.

Syntax

Function GetAttachedEntities3() As Variant
vElemente = swAnn.GetAttachedEntities3

Rückgabewert

Ein Array mit Objekten. Welche Art jedes Element hat, liefert Annotation.GetAttachedEntityTypes in derselben Reihenfolge:

Beispiel

' swAnn ist eine Beschriftung (Annotation), etwa aus der Auswahl.
Dim vElemente As Variant, vTypen As Variant
Dim i As Long
vElemente = swAnn.GetAttachedEntities3
vTypen = swAnn.GetAttachedEntityTypes
If IsEmpty(vElemente) Then
    Debug.Print "Hängt an keinem Element."
Else
    For i = 0 To UBound(vElemente)
        If vElemente(i) Is Nothing Then
            Debug.Print i & ": nichts (hängend oder nicht unterstützt)"
        Else
            Debug.Print i & ": Typ " & vTypen(i) & " (swSelectType_e)"
        End If
    Next i
End If

Bemerkungen

Der Befehl gilt für alle Arten von Beschriftungen.

Nothing im Array: An einer Stelle steht Nothing, wenn die Beschriftung an etwas hängt, das die Tabelle oben nicht kennt (etwa einem Ursprung), oder wenn sie die Verbindung zur Geometrie verloren hat. Annotation.GetAttachedEntityTypes liefert dort swSelNOTHING. Annotation.GetAttachedEntityCount3 zählt diese Stellen mit.

Leeres Array: Hängt die Beschriftung an gar nichts, etwa eine Notiz ohne Bezugslinie, kommt ein leeres Array. Ob das in VBA ein Array ohne Elemente oder Empty ist, sagt sie nicht. Das Beispiel prüft auf Empty. Ist es ein leeres Array, liefert UBound dort -1, und die Schleife läuft nicht.

Für eine Beschriftung, die an nichts hängt, etwa eine Notiz ohne Bezugslinie, kommt Empty.

Siehe auch

Verfügbarkeit

SOLIDWORKS 2008

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

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