SolidWorksMakroprogrammierung

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 Variant
vDaten = swView.GetEllipses5

Rü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 Beispiel swLF_SKETCH (2).
  • 2: Linienart aus swLineStyles_e, zum Beispiel swLineCONTINUOUS (0) oder swLineHIDDEN (1).
  • 3: Linienstärke aus swLineWeights_e, zum Beispiel swLW_THIN (0) oder swLW_NORMAL (1).
  • 4: ID des Layers. Den Layer dazu bekommst du mit LayerMgr.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 If

Bemerkungen

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.