Methode · View
GetEllipses5-Methode (View)
Liefert die Daten aller Ellipsen, die in einer Zeichenansicht skizziert wurden, als Array von Double-Werten.
Syntax
Function GetEllipses5() As VariantvDaten = swView.GetEllipses5Rückgabewert
Array von Double-Werten mit 22 Werten je Ellipse. Die Daten der ersten Ellipse stehen an Index 0 bis 21, die der zweiten an 22 bis 43 und so weiter. Innerhalb einer Ellipse:
- 0: Farbe als COLORREF-Zahl. 0 oder -1 bedeutet Standardfarbe.
- 1: Linientyp aus
swLineTypes_e, eine Kombination aus Linienart und Linienstärke, zum BeispielswLF_SKETCH(2). - 2: Linienart aus
swLineStyles_e, zum BeispielswLineCONTINUOUS(0) oderswLineHIDDEN(1). - 3: Linienstärke aus
swLineWeights_e, zum BeispielswLW_THIN(0) oderswLW_NORMAL(1). - 4: ID des Layers. Den
Layerdazu bekommst du mitLayerMgr.GetLayerById. - 5: Bitmaske, welche Eigenschaften gegenüber dem Layer abweichend eingestellt sind: 1 Farbe, 2 Linienart, 4 Linienstärke. Der Wert 3 heißt also: Farbe und Linienart weichen vom Layer ab.
- 6 bis 8: Startpunkt (x, y, z).
- 9 bis 11: Endpunkt (x, y, z). Bei einer geschlossenen Ellipse gleich dem Startpunkt.
- 12 bis 14: Mittelpunkt (x, y, z).
- 15 bis 17: ein Punkt auf der Ellipse, der auf der Hauptachse liegt.
- 18 bis 20: ein Punkt auf der Ellipse, der auf der Nebenachse liegt.
- 21: Richtung: -1 im Uhrzeigersinn, +1 gegen den Uhrzeigersinn.
Die Punkte sind Koordinaten im Raum der Ansicht, nicht auf dem Blatt (siehe Bemerkungen). Eine Einheit nennt die Hilfe nicht. Vermutlich sind es wie sonst in der API Meter.
Beispiel
' swView ist eine Zeichenansicht (View), etwa aus DrawingDoc.ActiveDrawingView oder der Auswahl.
Dim vDaten As Variant
Dim lAnzahl As Long
Dim lStart As Long
Dim i As Long
Dim dHaupt As Double
Dim dNeben As Double
lAnzahl = swView.GetEllipseCount
If lAnzahl > 0 Then
vDaten = swView.GetEllipses5
For i = 0 To lAnzahl - 1
lStart = i * 22
' Abstand Mittelpunkt bis Punkt auf der Haupt- bzw. Nebenachse
dHaupt = Sqr((vDaten(lStart + 15) - vDaten(lStart + 12)) ^ 2 + (vDaten(lStart + 16) - vDaten(lStart + 13)) ^ 2 + (vDaten(lStart + 17) - vDaten(lStart + 14)) ^ 2)
dNeben = Sqr((vDaten(lStart + 18) - vDaten(lStart + 12)) ^ 2 + (vDaten(lStart + 19) - vDaten(lStart + 13)) ^ 2 + (vDaten(lStart + 20) - vDaten(lStart + 14)) ^ 2)
Debug.Print "Ellipse " & i + 1 & ": Mitte " & Format(vDaten(lStart + 12) * 1000, "0.00") & " / " & Format(vDaten(lStart + 13) * 1000, "0.00") & " mm, Halbachsen " & Format(dHaupt * 1000, "0.00") & " und " & Format(dNeben * 1000, "0.00") & " mm"
Next i
End IfBemerkungen
GetEllipses5 liefert nur Ellipsen, die ein Benutzer in dieser Zeichenansicht skizziert hat. Die Geometrie von Teilen und Baugruppen in der Ansicht besteht aus Polylinien. Die holst du mit View.GetPolylines7. Die Hilfe nennt dafür noch die veralteten Vorgänger GetPolylines6 und GetPolylines3.
Die Koordinaten beziehen sich auf die Ansicht. Willst du Blattkoordinaten (Ursprung in der linken unteren Ecke des Blatts), kombinierst du sie mit den drei Werten von View.GetXform: Lage der Ansicht auf dem Blatt (x, y) und Maßstab der Ansicht. Wie genau die Umrechnung aussieht, beschreibt die Hilfe nicht. Das Beispiel gibt deshalb die Werte der Ansicht aus.
Das Blatt muss sichtbar sein. Sie verweist dazu auf Sheet.SheetFormatVisible, was eigentlich das Blattformat betrifft. Was hier genau gemeint ist, bleibt offen.
Ersetzt View.GetEllipses4. Der Vorgänger lieferte nur 20 Werte je Ellipse, ohne Layer-ID und Layer-Bitmaske.
Siehe auch
Verfügbarkeit
SOLIDWORKS 99
Englisches Original: IView::GetEllipses5 in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.