Methode · DisplayData
GetEllipseAtIndex2-Methode (DisplayData)
Liefert Farbe, Linientyp, Anfangs-, End- und Mittelpunkt und je einen Punkt auf der großen und kleinen Achse einer Ellipse in den Darstellungsdaten.
Syntax
Function GetEllipseAtIndex2( _
ByVal Index As Long _
) As VariantvEllipse = swAnzeige.GetEllipseAtIndex2(i)Parameter
IndexLongByVal- Nummer der Ellipse, beginnend bei
0.
Rückgabewert
Array aus Zahlen (Double): 0 die Farbe als COLORREF-Wert (0 oder -1 für die Standardfarbe), 1 der Linientyp aus swLineTypes_e, 2 und 3 unbenutzt, 4 bis 6 X, Y, Z des Anfangspunkts, 7 bis 9 des Endpunkts, 10 bis 12 des Mittelpunkts, 13 bis 15 ein Punkt auf der Ellipse und der großen Achse und 16 bis 18 ein Punkt auf der Ellipse und der kleinen Achse. Bei einer geschlossenen Ellipse ist der Endpunkt gleich dem Anfangspunkt.
Beispiel
' swAnzeige sind die Darstellungsdaten (DisplayData) einer Beschriftung, etwa aus Annotation.GetDisplayData.
Dim vEllipse As Variant
Dim dGross As Double, dKlein As Double
Dim i As Long
For i = 0 To swAnzeige.GetEllipseCount - 1
vEllipse = swAnzeige.GetEllipseAtIndex2(i)
dGross = Sqr((vEllipse(13) - vEllipse(10)) ^ 2 + (vEllipse(14) - vEllipse(11)) ^ 2 + (vEllipse(15) - vEllipse(12)) ^ 2)
dKlein = Sqr((vEllipse(16) - vEllipse(10)) ^ 2 + (vEllipse(17) - vEllipse(11)) ^ 2 + (vEllipse(18) - vEllipse(12)) ^ 2)
Debug.Print "Ellipse " & i & ": Halbachsen " & dGross & " und " & dKlein
Next iBemerkungen
Die Hilfe zählt 19 Zahlen auf, ihre Aufzählung endet aber mit einem Komma. Ob danach noch Werte kommen, sagt sie nicht. Prüf die Länge bei Bedarf mit UBound. Die Einheit der Koordinaten nennt die Hilfe nicht, vermutlich Meter.
Dass der Abstand vom Mittelpunkt zu den Achsenpunkten die Halbachsen ergibt, wie im Beispiel, folgt aus der Beschreibung der Hilfe („Punkt auf der Ellipse und der Achse“), sagt sie aber nicht ausdrücklich.
Ersetzt das veraltete GetEllipseAtIndex. Das lieferte die Werte ohne Farbe und unbenutzte Stellen, der Linientyp stand dort an Stelle 0.
Siehe auch
Verfügbarkeit
In allen aktuellen Versionen vorhanden. Seit wann es den Befehl gibt, nennt die Hilfe nicht.
Englisches Original: IDisplayData::GetEllipseAtIndex2 in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.