SolidWorksMakroprogrammierung

Methode · DisplayData

GetPolygonAtIndex-Methode (DisplayData)

Liefert Farbe, Linientyp und Eckpunkte eines Vielecks in den Darstellungsdaten.

Syntax

Function GetPolygonAtIndex( _
   ByVal Index As Long _
) As Variant
vVieleck = swAnzeige.GetPolygonAtIndex(i)

Parameter

IndexLongByVal
Nummer des Vielecks, beginnend bei 0.

Rückgabewert

Array aus Zahlen (Double): 0 die Farbe, 1 der Linientyp aus swLineTypes_e, 2 und 3 unbenutzt, 4 die Zahl der Eckpunkte und ab 5 je X, Y, Z der Eckpunkte. Wie viele Zahlen das Array hat, liefert DisplayData.GetPolygonSizeAtIndex.

Beispiel

' swAnzeige sind die Darstellungsdaten (DisplayData) einer Beschriftung, etwa aus Annotation.GetDisplayData.
Dim vVieleck As Variant
Dim i As Long, j As Long, k As Long
For i = 0 To swAnzeige.GetPolygonCount - 1
    vVieleck = swAnzeige.GetPolygonAtIndex(i)
    If Not IsEmpty(vVieleck) Then
        Debug.Print "Vieleck " & i & ": " & vVieleck(4) & " Eckpunkte"
        k = 5
        For j = 0 To vVieleck(4) - 1
            Debug.Print "  " & vVieleck(k) & " / " & vVieleck(k + 1) & " / " & vVieleck(k + 2)
            k = k + 3
        Next j
    End If
Next i

Bemerkungen

So liest das Hilfebeispiel „Get Weld Bead Symbol Data“ die Vielecke eines Schweißnahtsymbols aus. Nach WeldBead.SolidFill steckt dort die dreieckige Nahtdarstellung in den Vielecken.

Den Linientyp kannst du mit DrawingDoc.GetLineFontInfo2 und DrawingDoc.GetLineFontName2 verwenden. Die Farbe beschreibt die Hilfe nur als „Polygon color“, vermutlich ein COLORREF-Wert wie bei den Linien. Die Einheit der Koordinaten nennt sie nicht, vermutlich Meter.

Siehe auch

Verfügbarkeit

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

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

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