SolidWorksMakroprogrammierung

Methode · DisplayData

GetLineAtIndex3-Methode (DisplayData)

Liefert Farbe, Linientyp, Linienart, Linienstärke, Anfangs- und Endpunkt einer Linie in den Darstellungsdaten.

Syntax

Function GetLineAtIndex3( _
   ByVal Index As Long _
) As Variant
vLinie = swAnzeige.GetLineAtIndex3(i)

Parameter

IndexLongByVal
Nummer der Linie, beginnend bei 0.

Rückgabewert

Array mit 10 Zahlen (Double): 0 die Farbe als COLORREF-Wert (0 oder -1 für die Standardfarbe), 1 der Linientyp aus swLineTypes_e, 2 die Linienart aus swLineStyles_e, 3 die Linienstärke aus swLineWeights_e, 4 bis 6 X, Y, Z des Anfangspunkts und 7 bis 9 des Endpunkts.

Beispiel

' swAnzeige sind die Darstellungsdaten (DisplayData) einer Beschriftung, etwa aus Annotation.GetDisplayData.
Dim vLinie As Variant
Dim i As Long
For i = 0 To swAnzeige.GetLineCount - 1
    vLinie = swAnzeige.GetLineAtIndex3(i)
    Debug.Print "Linie " & i & ": Länge " & _
        Sqr((vLinie(7) - vLinie(4)) ^ 2 + (vLinie(8) - vLinie(5)) ^ 2 + (vLinie(9) - vLinie(6)) ^ 2) & _
        ", Linienart " & vLinie(2) & ", Linienstärke " & vLinie(3)
Next i

Bemerkungen

Die Einheit der Koordinaten nennt die Hilfe nicht, es sind Meter.

Die Hilfebeispiele „Get Centerline Annotation Information“ und „Get Weld Bead Symbol Data“ lesen damit die Linien einer ausgewählten Mittellinie (Centerline) und eines Schweißnahtsymbols (WeldBead) aus. Das erste gibt die zehn Werte der ersten Linie aus, das zweite Farbe, Linientyp, Linienart, Linienstärke und die beiden Punkte ab Stelle 4.

Ersetzt das veraltete GetLineAtIndex2. Dort waren die Stellen 2 und 3 unbenutzt. Das noch ältere GetLineAtIndex lieferte nur 7 Zahlen ohne Farbe, so wie Gtol.GetLineAtIndex.

Siehe auch

Verfügbarkeit

SOLIDWORKS 2008 SP03

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

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