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 VariantvLinie = 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 iBemerkungen
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.