SolidWorksMakroprogrammierung

Methode · Annotation

SetLeaderAttachmentPointAtIndex-Methode (Annotation)

Setzt den Anhängepunkt einer Bezugslinie einer Beschriftung.

Syntax

Function SetLeaderAttachmentPointAtIndex( _
   ByVal Index As Long, _
   ByVal X As Double, _
   ByVal Y As Double, _
   ByVal Z As Double _
) As Boolean
bErfolg = swAnn.SetLeaderAttachmentPointAtIndex(Index, X, Y, Z)

Parameter

IndexLongByVal
Der „Index der Beschriftung“. Das Beispiel der Hilfe übergibt bei einer Notiz mit einer Bezugslinie 0, gemeint ist also wohl die Nummer der Bezugslinie, siehe Bemerkungen.
XDoubleByVal
X des Anhängepunkts.
YDoubleByVal
Y des Anhängepunkts.
ZDoubleByVal
Z des Anhängepunkts.

Rückgabewert

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

Beispiel

' swAnn ist die Beschriftung (Annotation) einer Notiz mit einer Bezugslinie, etwa aus der Auswahl.
' Die Koordinaten sind Beispielwerte.
If swAnn.GetLeaderCount = 1 Then
    If swAnn.SetLeaderAttachmentPointAtIndex(0, 0.15, 0.1, 0) Then Debug.Print "Angehängt"
End If

Bemerkungen

Die Beschriftung muss Bezugslinien kennen. Das sind nur Notizen, Form- und Lagetoleranzen, Oberflächensymbole, Schweißsymbole, Bezugsstellensymbole und Blöcke.

Die Hilfe lässt vieles offen: in welchem Koordinatensystem und in welcher Einheit die Punkte liegen und was Index genau zählt. Ihr Beispiel übergibt für eine Notiz in einer Zeichnung X = 0.687, Y = 0.600 und Z = 250.03. Der Wert für Z passt nicht zu Blattkoordinaten in Metern. Prüfe das Ergebnis deshalb mit Annotation.GetLeaderPointsAtIndex.

In einer Zeichnung sind die Punkte Blattkoordinaten in Metern. Danach hängt die Beschriftung an keinem Element mehr (Annotation.GetAttachedEntityCount3 liefert 0).

Siehe auch

Verfügbarkeit

SOLIDWORKS 2018 SP02

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

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