SolidWorksMakroprogrammierung

Methode · DisplayData

GetPolylineAtIndex2-Methode (DisplayData)

Liefert Art, Farbe, Linientyp und Punkte einer Polylinie in den Darstellungsdaten.

Syntax

Function GetPolylineAtIndex2( _
   ByVal Index As Long _
) As Variant
vPoly = swAnzeige.GetPolylineAtIndex2(i)

Parameter

IndexLongByVal
Nummer der Polylinie, beginnend bei 0.

Rückgabewert

Array aus Zahlen (Double): 0 die Art der zugrunde liegenden Geometrie (0 Polylinie, 1 Bogen oder Kreis), 1 die Zahl der Werte der Geometriedaten (bei Art 0 ist sie 0), 2 die Farbe, 3 der Linientyp (line font), 4 und 5 unbenutzt, 6 die Zahl der Punkte und danach je X, Y, Z der Punkte. Wie viele Zahlen das Array hat, liefert DisplayData.GetPolylineSizeAtIndex2.

Beispiel

' swAnzeige sind die Darstellungsdaten (DisplayData) einer Beschriftung, etwa aus Annotation.GetDisplayData.
Dim vPoly As Variant
Dim i As Long, j As Long, k As Long
For i = 0 To swAnzeige.GetPolyLineCount - 1
    vPoly = swAnzeige.GetPolylineAtIndex2(i)
    If Not IsEmpty(vPoly) Then
        Debug.Print "Polylinie " & i & ": Art " & vPoly(0) & ", " & vPoly(6) & " Punkte"
        If vPoly(1) = 0 Then                ' ohne Geometriedaten stehen die Punkte ab Stelle 7
            k = 7
            For j = 0 To vPoly(6) - 1
                Debug.Print "  " & vPoly(k) & " / " & vPoly(k + 1) & " / " & vPoly(k + 2)
                k = k + 3
            Next j
        End If
    End If
Next i

Bemerkungen

Der Befehl liefert die Punkte für jede Polylinie, gleich welcher Art. Wo im Array die Geometriedaten stehen, deren Zahl an Stelle 1 steht, sagt die Hilfe nicht. Ohne Geometriedaten stehen die Punkte vermutlich direkt ab Stelle 7, das Beispiel liest die Punkte deshalb nur in diesem Fall.

Den Linientyp kannst du mit DrawingDoc.GetLineFontInfo2 und DrawingDoc.GetLineFontName2 verwenden. Die Hilfe sagt, er gelte nur, wenn „LineStyle“ -1 ist, einen solchen Wert enthält das Array aber nicht. Die Farbe beschreibt die Hilfe nur als „Polyline color“, vermutlich ein COLORREF-Wert. Die Einheit der Koordinaten nennt sie nicht, vermutlich Meter.

Ersetzt das veraltete GetPolylineAtIndex. Das lieferte Farbe, Linientyp, zwei unbenutzte Stellen, die Zahl der Punkte und die Punkte, ohne Art und Geometriedaten.

Siehe auch

Verfügbarkeit

In allen aktuellen Versionen vorhanden. Seit wann es den Befehl gibt, nennt die Hilfe nicht.

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

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