SolidWorksMakroprogrammierung

Objekt · SldWorks

EdgePoint-Objekt

Steht für einen Kantenpunkt: den Mittelpunkt einer Kante oder einen End- oder Mittelpunkt einer Referenzkurve.

Deklaration Dim x As SldWorks.EdgePoint · in der englischen .NET-Hilfe: IEdgePoint

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

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 Sub

Bemerkungen

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

NameBeschreibung
EntityLiest oder setzt die Kante oder Referenzkurve, auf der der Kantenpunkt liegt.
PositionLiest oder setzt, wo der Kantenpunkt auf der Kante oder Referenzkurve liegt, von 0 (Anfang) bis 100 (Ende).

Methoden 2, davon 2 beschrieben

NameBeschreibung
GetPointCoordinatesLiefert die Koordinaten des Kantenpunkts.
SelectWä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.