Methode · Annotation
GetAttachedEntities3-Methode (Annotation)
Liefert die Elemente, an denen eine Beschriftung hängt, etwa Flächen, Kanten oder Skizzenpunkte.
Syntax
Function GetAttachedEntities3() As VariantvElemente = swAnn.GetAttachedEntities3Rückgabewert
Ein Array mit Objekten. Welche Art jedes Element hat, liefert Annotation.GetAttachedEntityTypes in derselben Reihenfolge:
swSelFACES:Face2swSelEDGES:EdgeswSelVERTICES:VertexswSelSKETCHSEGS:SketchSegmentswSelSKETCHPOINTS:SketchPointswSelSilhouettes:SilhouetteEdgeswSelNOTHING:Nothing, die Beschriftung hängt dort an nichts mehr oder an etwas, das die API nicht kennt
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 IfBemerkungen
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.