SolidWorksMakroprogrammierung

Objekt · SldWorks

EnumCoEdges-Objekt

Eine Aufzählung von Teilkanten (CoEdge) einer Kante oder Schleife, die du mit Next Teilkante für Teilkante durchgehst.

Deklaration Dim x As SldWorks.EnumCoEdges · in der englischen .NET-Hilfe: IEnumCoEdges

Beschreibung

EnumCoEdges gibt Zugriff auf eine Aufzählung von Teilkanten (CoEdge). 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.

EnumCoEdges ist nur für In-Process-DLLs gedacht. In VBA-Makros nimmst du meist besser Loop2.GetCoEdges oder Edge.GetCoEdges, das gleich ein Array liefert.

Alle Teilkanten holen: Du rufst EnumCoEdges.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 EnumCoEdges.Reset fängst du wieder von vorn an.

Zugriff

Beispiel

' Gibt für die ausgewählte Kante ihre Teilkanten und deren Richtung aus.
' Vorbedingung: In einem Teil ist eine Kante ausgewählt.
' Ergebnis:     Je Teilkante steht im Direktfenster, ob sie wie die Kante läuft.
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swSelMgr As SldWorks.SelectionMgr
    Dim swKante As SldWorks.Edge
    Dim swEnum As SldWorks.EnumCoEdges
    Dim swCoEdge As SldWorks.CoEdge
    Dim nGeholt As Long, n 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) <> swSelEDGES Then Exit Sub
    Set swKante = swSelMgr.GetSelectedObject6(1, -1)
    Set swEnum = swKante.EnumCoEdges
    If swEnum Is Nothing Then Exit Sub

    Do
        Set swCoEdge = Nothing
        swEnum.Next 1, swCoEdge, nGeholt
        If swCoEdge Is Nothing Then Exit Do
        n = n + 1
        Debug.Print "Teilkante " & n & ": " & IIf(swCoEdge.GetSense, "wie die Kante", "gegen die Kante")
    Loop
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 CoEdge, deshalb holst du vermutlich immer genau 1 Element. PceltFetched ist kleiner als Celt, wenn weniger Teilkanten ü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.EnumCoEdges kommen die Teilkanten einer Schleife in deren Richtung, also bei Außenschleifen gegen den Uhrzeigersinn und bei Innenschleifen im Uhrzeigersinn. Die Richtung der Teilkante stimmt immer mit der Schleife überein, siehe Loop2.

Eigenschaften und Methoden

Methoden 4, davon 4 beschrieben

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

Siehe auch

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

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