SolidWorksMakroprogrammierung

Objekt · SldWorks

SketchEllipse-Objekt

Eine Ellipse oder ein Ellipsenbogen in einer Skizze: Mittelpunkt, Punkte auf den beiden Achsen, Anfangs- und Endpunkt und Drehrichtung.

Deklaration Dim x As SldWorks.SketchEllipse · in der englischen .NET-Hilfe: ISketchEllipse

Beschreibung

SketchEllipse gibt Zugriff auf Ellipsen in einer Skizze. Eine Ellipse ist zugleich ein SketchSegment. Was alle Skizzenelemente gemeinsam haben, liegt dort, hier liegen nur die Punkte, die eine Ellipse festlegen. Die Befehle gibt es seit SOLIDWORKS 2000, GetRotationDir seit 2007.

Alle Punkte sind SketchPoint-Objekte.

Zugriff

Beispiel

' Gibt für jede Ellipse der offenen Skizze den Mittelpunkt und die Längen der
' beiden Halbachsen aus.
' Vorbedingung: Eine Skizze mit mindestens einer Ellipse ist zum Bearbeiten offen.
' Ergebnis:     Die Werte stehen im Direktfenster, in Millimetern.
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swSketch As SldWorks.Sketch
    Dim vElemente As Variant
    Dim swSeg As SldWorks.SketchSegment
    Dim swEllipse As SldWorks.SketchEllipse
    Dim swMitte As SldWorks.SketchPoint
    Dim swGross As SldWorks.SketchPoint
    Dim swKlein As SldWorks.SketchPoint
    Dim i As Long

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Then Exit Sub
    Set swSketch = swModel.SketchManager.ActiveSketch
    If swSketch Is Nothing Then Exit Sub

    vElemente = swSketch.GetSketchSegments
    If Not IsArray(vElemente) Then Exit Sub
    For i = 0 To UBound(vElemente)
        Set swSeg = vElemente(i)
        If swSeg.GetType = swSketchELLIPSE Then
            Set swEllipse = swSeg                      ' dasselbe Element als SketchEllipse
            Set swMitte = swEllipse.GetCenterPoint2
            Set swGross = swEllipse.GetMajorPoint2
            Set swKlein = swEllipse.GetMinorPoint2
            Debug.Print "Mitte " & Format(swMitte.X * 1000, "0.00") & " / " & Format(swMitte.Y * 1000, "0.00") & _
                        " mm, Halbachsen " & Format(Abstand(swMitte, swGross) * 1000, "0.00") & " und " & _
                        Format(Abstand(swMitte, swKlein) * 1000, "0.00") & " mm"
        End If
    Next i
End Sub

Function Abstand(p1 As SldWorks.SketchPoint, p2 As SldWorks.SketchPoint) As Double
    Abstand = Sqr((p2.X - p1.X) ^ 2 + (p2.Y - p1.Y) ^ 2 + (p2.Z - p1.Z) ^ 2)
End Function

Bemerkungen

Achsenpunkte: Die Hilfe sagt nur „major point“ und „minor point“. Das Hilfebeispiel „Create Ellipse“ rechnet den Abstand dieser Punkte zum Mittelpunkt als Länge der großen und der kleinen Halbachse. Sie liegen an den Enden der Halbachsen. Das Beispiel oben macht es genauso.

Einheiten: Die Koordinaten der Punkte sind Meter in Skizzenkoordinaten, wie bei allen Skizzenpunkten. Das Hilfebeispiel rechnet sie mit 1000 in Millimeter um.

Fehler: Die Get…Point2-Methoden liefern Nothing, wenn es nicht klappt.

Veraltete Befehle: GetCenterPoint, GetEndPoint, GetMajorPoint, GetMinorPoint und GetStartPoint sind veraltet. An ihre Stelle treten die Methoden mit der Endung 2, etwa SketchEllipse.GetCenterPoint2.

Eigenschaften und Methoden

Methoden 11, davon 6 beschrieben, 5 veraltet

NameBeschreibung
GetCenterPointveraltet ersetzt durch SketchEllipse.GetCenterPoint2
GetCenterPoint2Liefert den Mittelpunkt der Ellipse als SketchPoint.
GetEndPointveraltet ersetzt durch SketchEllipse.GetEndPoint2
GetEndPoint2Liefert den Endpunkt der Ellipse als SketchPoint.
GetMajorPointveraltet ersetzt durch SketchEllipse.GetMajorPoint2
GetMajorPoint2Liefert den Punkt auf der großen Achse der Ellipse als SketchPoint.
GetMinorPointveraltet ersetzt durch SketchEllipse.GetMinorPoint2
GetMinorPoint2Liefert den Punkt auf der kleinen Achse der Ellipse als SketchPoint.
GetRotationDirLiefert, in welche Richtung ein Ellipsenbogen vom Anfangs- zum Endpunkt läuft: gegen oder mit dem Uhrzeigersinn.
GetStartPointveraltet ersetzt durch SketchEllipse.GetStartPoint2
GetStartPoint2Liefert den Anfangspunkt der Ellipse als SketchPoint.

Nicht aufgeführt sind 10 C++-Varianten (Namen mit I davor, zum Beispiel IGetCenterPoint). In VBA nimmst du immer den Befehl ohne I.

Siehe auch

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

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