SolidWorksMakroprogrammierung

Objekt · SldWorks

EnumEdges-Objekt

Eine Aufzählung von Kanten (Edge), etwa einer Fläche, einer Schleife oder an einem Eckpunkt, die du mit Next Kante für Kante durchgehst.

Deklaration Dim x As SldWorks.EnumEdges · in der englischen .NET-Hilfe: IEnumEdges

Beschreibung

EnumEdges gibt Zugriff auf eine Aufzählung von Kanten (Edge). Eine Aufzählung gibt dir die Elemente nicht als Array, sondern eins nach dem anderen. Seit wann es die Befehle gibt, sagt die Hilfe nicht.

EnumEdges ist nur für In-Process-DLLs gedacht. In VBA-Makros nimmst du meist besser Face2.GetEdges, Loop2.GetEdges oder Vertex.GetEdges, das gleich ein Array liefert.

Alle Kanten holen: Du rufst EnumEdges.Next in einer Schleife mit 1 auf. Vor jedem Aufruf setzt du die Variable für das Element auf Nothing. Ist sie danach noch Nothing, ist die Aufzählung zu Ende. Mit EnumEdges.Reset fängst du wieder von vorn an.

Zugriff

Beispiel

' Zählt die Kanten der ausgewählten Fläche und wie viele davon gerade sind.
' Vorbedingung: In einem Teil ist eine Fläche ausgewählt.
' Ergebnis:     Die Zahlen stehen im Direktfenster.
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swSelMgr As SldWorks.SelectionMgr
    Dim swFace As SldWorks.Face2
    Dim swEnum As SldWorks.EnumEdges
    Dim swKante As SldWorks.Edge
    Dim nGeholt As Long, n As Long, nGerade As Long

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Then Exit Sub
    Set swSelMgr = swModel.SelectionManager
    If swSelMgr.GetSelectedObjectType3(1, -1) <> swSelFACES Then Exit Sub
    Set swFace = swSelMgr.GetSelectedObject6(1, -1)
    Set swEnum = swFace.EnumEdges
    If swEnum Is Nothing Then Exit Sub

    Do
        Set swKante = Nothing
        swEnum.Next 1, swKante, nGeholt
        If swKante Is Nothing Then Exit Do
        n = n + 1
        If swKante.GetCurve.IsLine Then nGerade = nGerade + 1
    Loop
    Debug.Print n & " Kanten, davon " & nGerade & " gerade"
End Sub

Bemerkungen

Next in VBA: Next gibt in Rgelt ein Array mit Celt Elementen zurück. Die VBA-Syntax deklariert Rgelt aber als einzelnes Edge, deshalb holst du vermutlich immer genau 1 Element. PceltFetched ist kleiner als Celt, wenn weniger Kanten übrig sind, oder NULL, wenn keine mehr da sind. Welchen Wert die Variable dann in VBA hat, sagt die Hilfe nicht. Die Schleife prüft deshalb das Element selbst.

Rückgabe: In VBA sind alle vier Befehle Funktionen mit einem HResult. Was der Wert bedeutet, sagt die Hilfe nicht. Du rufst sie ohne Klammern auf und lässt den Wert weg.

Reihenfolge: Bei Loop2.EnumEdges kommen die Kanten einer Schleife in deren Richtung. Weil eine Kante zu mehreren Schleifen gehört, kann ihre eigene Richtung entgegengesetzt sein, das prüfst du mit Edge.EdgeInFaceSense. Vertex.EnumEdgesOriented liefert die Kanten an einem Eckpunkt gegen den Uhrzeigersinn. Rufst du Face2.EnumEdges direkt nach Face2.GetTrimCurves2 auf, passt die Reihenfolge der Kanten zu den Begrenzungskurven.

Skizzentext: Bei SketchText.EnumEdges sind diese Kanten nur vorübergehend da und nur zum Lesen gedacht, etwa für ihre Kurven. Du speicherst sie nicht, sondern holst sie bei Bedarf neu.

Eigenschaften und Methoden

Methoden 4, davon 4 beschrieben

NameBeschreibung
CloneErstellt eine Kopie der Aufzählung der Kanten.
NextHolt die nächste Kante aus der Aufzählung.
ResetSetzt die Aufzählung an den Anfang zurück, sodass Next wieder die erste Kante liefert.
SkipÜberspringt die angegebene Zahl von Kanten in der Aufzählung.

Siehe auch

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

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