SolidWorksMakroprogrammierung

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 Variant
vPunkte = swAnn.GetLeaderPointsAtIndex(Index)

Parameter

IndexLongByVal
Nummer der Bezugslinie, beginnend bei 0, kleiner als Annotation.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 Punkte
  • swSTRAIGHT und swUNDERLINED: 2 Punkte
  • swBENT: 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 i

Bemerkungen

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.