Methode · DisplayData
GetPolylineAtIndex2-Methode (DisplayData)
Liefert Art, Farbe, Linientyp und Punkte einer Polylinie in den Darstellungsdaten.
Syntax
Function GetPolylineAtIndex2( _
ByVal Index As Long _
) As VariantvPoly = 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 iBemerkungen
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.