SolidWorksMakroprogrammierung

Methode · Annotation

SetAttachedEntities-Methode (Annotation)

Hängt eine Beschriftung an andere Elemente, etwa an eine Fläche, Kante oder einen Eckpunkt.

Syntax

Function SetAttachedEntities( _
   ByVal AttachedEnts As Variant _
) As Boolean
bErfolg = swAnn.SetAttachedEntities(AttachedEnts)

Parameter

AttachedEntsVariantByVal
Array mit den Elementen, an die die Beschriftung gehängt wird.

Rückgabewert

True, wenn die Beschriftung angehängt wurde, sonst False.

Beispiel

' swModel ist das Dokument (ModelDoc2), swAnn eine Beschriftung (Annotation) darin.
' Vorbedingung: Eine Kante ist ausgewählt (in einer Zeichnung ist die Ansicht mit ausgewählt).
Dim swSelMgr As SldWorks.SelectionMgr
Dim aElemente(0) As Object
Dim vElemente As Variant
Dim i As Long
Set swSelMgr = swModel.SelectionManager
For i = 1 To swSelMgr.GetSelectedObjectCount2(-1)
    If swSelMgr.GetSelectedObjectType3(i, -1) = swSelEDGES Then
        Set aElemente(0) = swSelMgr.GetSelectedObject6(i, -1)
        Exit For
    End If
Next i
If aElemente(0) Is Nothing Then Exit Sub
vElemente = aElemente
If False = swAnn.SetAttachedEntities(vElemente) Then Debug.Print "Nicht angehängt"

Bemerkungen

Nicht jede Beschriftung lässt sich an ein anderes Element hängen. Welche Beschriftung an welche Elemente gehängt werden kann, sollst du ausprobieren. Prüfe deshalb den Rückgabewert und danach Annotation.GetAttachedEntities3.

Das Hilfebeispiel dazu heißt „Attach Annotation to Entity“.

Wählst du in einer Zeichnung eine Kante mit ModelDocExtension.SelectByID2 aus, ist die Zeichenansicht mit ausgewählt und steht an erster Stelle. Mit der Ansicht liefert der Befehl False, such deshalb die Kante in der Auswahl, wie im Beispiel; eine Notiz vom Blatt gehört danach zur Zeichenansicht der Kante.

Siehe auch

Verfügbarkeit

SOLIDWORKS 2007

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

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