Methode · Annotation
GetLeaderPointsAtIndex-Methode (Annotation)
Liefert die Punkte einer Bezugslinie einer Beschriftung: zwei bei gerader, drei bei geknickter Bezugslinie.
Syntax
Function GetLeaderPointsAtIndex( _
ByVal Index As Long _
) As VariantvPunkte = swAnn.GetLeaderPointsAtIndex(Index)Parameter
IndexLongByVal- Nummer der Bezugslinie, beginnend bei
0, kleiner alsAnnotation.GetLeaderCount.
Rückgabewert
Ein Array mit Double-Werten: X, Y, Z des ersten Punkts, dann X, Y, Z des zweiten und gegebenenfalls des dritten. Wie viele Punkte es sind, hängt von Annotation.GetLeaderStyle ab:
swNO_LEADER: keine PunkteswSTRAIGHTundswUNDERLINED: 2 PunkteswBENT: 3 Punkte
Bei ungültigem Index kommt ein leeres Array. Eine Einheit nennt die Hilfe nicht. Vermutlich sind es wie sonst in der API Meter.
Beispiel
' swAnn ist eine Beschriftung (Annotation) mit Bezugslinien, etwa eine Notiz aus der Auswahl.
Dim vPunkte As Variant
Dim i As Long, j As Long
For i = 0 To swAnn.GetLeaderCount - 1
vPunkte = swAnn.GetLeaderPointsAtIndex(i)
If Not IsEmpty(vPunkte) Then
For j = 0 To UBound(vPunkte) Step 3
Debug.Print "Bezugslinie " & i & ", Punkt " & j \ 3 & ": " & _
Format(vPunkte(j) * 1000, "0.0") & " / " & Format(vPunkte(j + 1) * 1000, "0.0") & " mm"
Next j
End If
Next iBemerkungen
Die Hilfe nennt den Rückgabewert „Array of objects“, beschreibt dann aber Koordinaten. Das Beispiel liest Zahlen.
Welcher der Punkte an der Beschriftung und welcher an der Pfeilspitze liegt, sagt die Hilfe nicht.
Die Punkte lassen sich nicht direkt setzen. SOLIDWORKS berechnet sie aus der Lage des Texts und der Anhängepunkte. Die Lage des Texts setzt du mit Annotation.SetPosition2.
Die Koordinaten sind in Metern. Der erste Punkt liegt am Text, der letzte am Anhängepunkt.
Siehe auch
Verfügbarkeit
SOLIDWORKS 99
Englisches Original: IAnnotation::GetLeaderPointsAtIndex in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.