Objekt · SldWorks
SketchEllipse-Objekt
Eine Ellipse oder ein Ellipsenbogen in einer Skizze: Mittelpunkt, Punkte auf den beiden Achsen, Anfangs- und Endpunkt und Drehrichtung.
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
SketchManager.CreateEllipseundSketchManager.CreateEllipticalArc: zeichnen eine neue Ellipse oder einen EllipsenbogenSketch.GetSketchSegmentsundSketchSegment.GetType=swSketchELLIPSE, dann einer Variablen vom Typ SketchEllipse zuweisen
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 FunctionBemerkungen
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
| Name | Beschreibung |
|---|---|
| GetCenterPoint | veraltet ersetzt durch SketchEllipse.GetCenterPoint2 |
| GetCenterPoint2 | Liefert den Mittelpunkt der Ellipse als SketchPoint. |
| GetEndPoint | veraltet ersetzt durch SketchEllipse.GetEndPoint2 |
| GetEndPoint2 | Liefert den Endpunkt der Ellipse als SketchPoint. |
| GetMajorPoint | veraltet ersetzt durch SketchEllipse.GetMajorPoint2 |
| GetMajorPoint2 | Liefert den Punkt auf der großen Achse der Ellipse als SketchPoint. |
| GetMinorPoint | veraltet ersetzt durch SketchEllipse.GetMinorPoint2 |
| GetMinorPoint2 | Liefert den Punkt auf der kleinen Achse der Ellipse als SketchPoint. |
| GetRotationDir | Liefert, in welche Richtung ein Ellipsenbogen vom Anfangs- zum Endpunkt läuft: gegen oder mit dem Uhrzeigersinn. |
| GetStartPoint | veraltet ersetzt durch SketchEllipse.GetStartPoint2 |
| GetStartPoint2 | Liefert 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.