Objekt · SldWorks
EdgePoint-Objekt
Steht für einen Kantenpunkt: den Mittelpunkt einer Kante oder einen End- oder Mittelpunkt einer Referenzkurve.
Beschreibung
EdgePoint gibt Zugriff auf den Mittelpunkt einer Kante oder auf einen End- oder Mittelpunkt einer Referenzkurve. Ein solcher Kantenpunkt ist kein eigenes Element des Körpers wie ein Vertex, sondern ein Punkt, den du im Grafikbereich auswählen kannst. Die Befehle gibt es seit SOLIDWORKS 2004.
Zugriff
SelectionMgr.GetSelectedObject6: ein ausgewählter Kantenpunkt (TypswSelPOINTREFS)
Per API wählst du einen Kantenpunkt mit ModelDocExtension.SelectByID2 und dem Typ POINTREF aus. Das Hilfebeispiel „Create Reference Curve“ macht das nach dem Erzeugen einer Referenzkurve ohne Namen und ohne Koordinaten.
Beispiel
' Gibt Lage, Koordinaten und Träger des ausgewählten Kantenpunkts aus.
' Vorbedingung: In einem Teil ist ein Kantenpunkt ausgewählt, etwa der Mittelpunkt einer Kante
' oder ein Endpunkt einer Referenzkurve.
' Ergebnis: Die Angaben stehen im Direktfenster (Strg+G).
Option Explicit
Sub main()
Dim swApp As SldWorks.SldWorks
Dim swModel As SldWorks.ModelDoc2
Dim swSelMgr As SldWorks.SelectionMgr
Dim swPunkt As SldWorks.EdgePoint
Dim swTraeger As Object
Dim x As Double, y As Double, z As Double
Set swApp = Application.SldWorks
Set swModel = swApp.ActiveDoc
If swModel Is Nothing Then Exit Sub
Set swSelMgr = swModel.SelectionManager
If swSelMgr.GetSelectedObjectType3(1, -1) <> swSelPOINTREFS Then
Debug.Print "Kein Kantenpunkt ausgewählt."
Exit Sub
End If
Set swPunkt = swSelMgr.GetSelectedObject6(1, -1)
Debug.Print "Lage: " & swPunkt.Position & " (0 = Anfang, 100 = Ende)"
swPunkt.GetPointCoordinates x, y, z
Debug.Print "Punkt: " & Format(x * 1000, "0.000") & " / " & _
Format(y * 1000, "0.000") & " / " & Format(z * 1000, "0.000") & " mm"
Set swTraeger = swPunkt.Entity
If TypeOf swTraeger Is SldWorks.Edge Then
Debug.Print "Liegt auf einer Kante."
ElseIf TypeOf swTraeger Is SldWorks.ReferenceCurve Then
Debug.Print "Liegt auf einer Referenzkurve."
End If
End SubBemerkungen
Einheiten: Die Hilfe nennt für EdgePoint.GetPointCoordinates keine Einheit. Es sind wie sonst in der API Meter. Bei EdgePoint.Position nennt sie nur den Bereich 0 bis 100, es ist Prozent der Länge.
Hilfebeispiele: „Get Edge Points“ holt ausgewählte Kantenpunkte noch mit dem älteren GetSelectedObject5, „Create Reference Curve“ mit SelectionMgr.GetSelectedObject6 und gibt Position und Koordinaten eines Endpunkts aus.
Auswählen: Anders als Face2, Edge oder Vertex zählt die Hilfe EdgePoint nicht zu den Objekten, die du einer Entity-Variable zuweisen kannst. Zum Auswählen hat EdgePoint deshalb eine eigene Methode EdgePoint.Select.
Achtung: ModelDocExtension.SelectByID2 mit dem Typ „POINTREF“ kann den Mittelpunkt einer anderen Kante treffen als der angegebene Punkt, etwa den der hinteren statt der vorderen Kante. Prüf deshalb mit EdgePoint.GetPointCoordinates, welcher Kantenpunkt ausgewählt ist.
Eigenschaften und Methoden
Eigenschaften 2, davon 2 beschrieben
| Name | Beschreibung |
|---|---|
| Entity | Liest oder setzt die Kante oder Referenzkurve, auf der der Kantenpunkt liegt. |
| Position | Liest oder setzt, wo der Kantenpunkt auf der Kante oder Referenzkurve liegt, von 0 (Anfang) bis 100 (Ende). |
Methoden 2, davon 2 beschrieben
| Name | Beschreibung |
|---|---|
| GetPointCoordinates | Liefert die Koordinaten des Kantenpunkts. |
| Select | Wählt den Kantenpunkt aus und gibt ihm eine Markierung. |
Siehe auch
Englisches Original: IEdgePoint in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.