SolidWorksMakroprogrammierung

Objekt · SldWorks

Vertex-Objekt

Steht für einen Eckpunkt eines Körpers: den Anfang oder das Ende einer Kante.

Deklaration Dim x As SldWorks.Vertex · in der englischen .NET-Hilfe: IVertex

Beschreibung

Ein Eckpunkt liegt dort, wo Kanten zusammentreffen, an jedem Ende einer offenen Kante gibt es einen. Geschlossene Kanten wie ein voller Kreis haben keinen Eckpunkt. Die Lage holst du mit Vertex.GetPoint.

Zugriff

Beispiel

' Gibt die Koordinaten aller Eckpunkte des ersten Körpers aus.
' Vorbedingung: Ein Teil mit einem Volumenkörper ist geöffnet.
' Ergebnis:     Eine Zeile je Eckpunkt im Direktfenster (Strg+G).
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swPart As SldWorks.PartDoc
    Dim swBody As SldWorks.Body2
    Dim swVertex As SldWorks.Vertex
    Dim vBodies As Variant, vEcken As Variant, vPunkt As Variant
    Dim i As Long

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Then Exit Sub
    If swModel.GetType <> swDocPART Then Exit Sub
    Set swPart = swModel
    vBodies = swPart.GetBodies2(swSolidBody, True)
    If IsEmpty(vBodies) Then Exit Sub
    Set swBody = vBodies(0)

    vEcken = swBody.GetVertices
    If IsEmpty(vEcken) Then Exit Sub
    For i = 0 To UBound(vEcken)
        Set swVertex = vEcken(i)
        vPunkt = swVertex.GetPoint
        Debug.Print i & ": " & Format(vPunkt(0) * 1000, "0.000") & " / " & _
            Format(vPunkt(1) * 1000, "0.000") & " / " & Format(vPunkt(2) * 1000, "0.000") & " mm, " & _
            UBound(swVertex.GetEdges) + 1 & " Kanten"
    Next i
End Sub

Bemerkungen

Zum Auswählen weist du den Eckpunkt einer Variable vom Typ SldWorks.Entity zu und rufst Entity.Select4 auf. Koordinaten sind in Metern.

Die Liste der Kanten gibt es zweimal: Vertex.GetEdges und Vertex.GetEdgesOriented. Was „oriented“ genau bedeutet, beschreibt die Hilfe nur knapp, siehe dort.

Eigenschaften und Methoden

Methoden 13, davon 13 beschrieben

NameBeschreibung
DisplayZeigt einen Eckpunkt als farbigen Kreis im Grafikbereich an oder blendet ihn wieder aus.
EnumEdgesLiefert die Kanten an einem Eckpunkt als Aufzählung (EnumEdges).
EnumEdgesOrientedLiefert die Kanten an einem Eckpunkt geordnet gegen den Uhrzeigersinn als Aufzählung (EnumEdges).
GetAdjacentFacesLiefert die Flächen, die an einem Eckpunkt anliegen.
GetClosestPointOnLiefert zu einem gegebenen Punkt den nächsten Punkt am Eckpunkt, also den Eckpunkt selbst.
GetEdgesLiefert die Kanten, die an einem Eckpunkt enden.
GetEdgesOrientedLiefert die Kanten an einem Eckpunkt in geordneter Reihenfolge gegen den Uhrzeigersinn.
GetPointLiefert die Koordinaten eines Eckpunkts.
GetTrackingIDsLiefert die Tracking-IDs eines Eckpunkts zu einer Tracking-Definition.
GetTrackingIDsCountLiefert die Anzahl der Tracking-IDs eines Eckpunkts zu einer Tracking-Definition.
IsTolerantPrüft, ob ein Eckpunkt tolerant ist, und liefert die Größe des Spalts.
RemoveTrackingIDEntfernt die Tracking-ID einer Tracking-Definition von einem Eckpunkt.
SetTrackingIDGibt einem Eckpunkt eine eigene Tracking-ID, an der du ihn nach Änderungen wiedererkennst.

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

Siehe auch

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

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