SolidWorksMakroprogrammierung

Objekt · SldWorks

CoEdge-Objekt

Steht für eine Teilkante: das Stück einer Kante, das zu genau einer Schleife einer Fläche gehört, mit fester Richtung.

Deklaration Dim x As SldWorks.CoEdge · in der englischen .NET-Hilfe: ICoEdge

Beschreibung

Eine Kante zwischen zwei Flächen gehört zu zwei Schleifen, zu jeder Fläche eine. Für jede dieser Schleifen gibt es eine eigene Teilkante (CoEdge). Die beiden Teilkanten einer Kante heißen Partner, du wechselst mit CoEdge.GetPartner von einer zur anderen und damit zur Nachbarfläche.

Anders als eine Edge hat eine Teilkante eine Richtung: Sie läuft so, wie die Schleife um ihre Fläche läuft. Ob diese Richtung mit der Kante übereinstimmt, sagt CoEdge.GetSense.

Zugriff

Beispiel

' Wählt alle Flächen aus, die an die ausgewählte Fläche grenzen.
' Vorbedingung: In einem Teil ist eine Fläche ausgewählt.
' Ergebnis:     Die Nachbarflächen sind zusätzlich ausgewählt.
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 swLoop As SldWorks.Loop2
    Dim swCoEdge As SldWorks.CoEdge
    Dim swErste As SldWorks.CoEdge
    Dim swPartner As SldWorks.CoEdge
    Dim swEntity As SldWorks.Entity

    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
        swApp.SendMsgToUser2 "Bitte zuerst eine Fläche auswählen.", swMbWarning, swMbOk
        Exit Sub
    End If
    Set swFace = swSelMgr.GetSelectedObject6(1, -1)

    Set swLoop = swFace.GetFirstLoop
    Do While Not swLoop Is Nothing
        Set swErste = swLoop.GetFirstCoEdge
        Set swCoEdge = swErste
        Do
            Set swPartner = swCoEdge.GetPartner
            ' Am freien Rand eines Flächenkörpers kann der Partner fehlen.
            If Not swPartner Is Nothing Then
                If Not swPartner.GetLoop.GetFace Is swFace Then
                    Set swEntity = swPartner.GetLoop.GetFace
                    swEntity.Select4 True, Nothing
                End If
            End If
            Set swCoEdge = swCoEdge.GetNext
        Loop Until swCoEdge Is swErste
        Set swLoop = swLoop.GetNext
    Loop
End Sub

Bemerkungen

Ringförmig: CoEdge.GetNext liefert nie Nothing, nach der letzten Teilkante kommt wieder die erste. Die Schleife im Beispiel bricht darum ab, wenn sie wieder bei der ersten ankommt. Auch die Hilfebeispiele erkennen das Ende der Runde mit Is.

Freie Ränder: Was CoEdge.GetPartner am offenen Rand eines Flächenkörpers liefert, sagt die Hilfe nicht. Das Beispiel prüft darum auf Nothing.

Eigenschaften und Methoden

Methoden 9, davon 8 beschrieben, 1 veraltet

NameBeschreibung
Evaluateveraltet ersetzt durch CoEdge.Evaluate2
Evaluate2Berechnet Punkt und Ableitungen einer Teilkante an einer Stelle, mit der Tangente in Laufrichtung der Teilkante.
GetCurveLiefert eine eigene Kurve der Teilkante, die es nur bei ungenau vernähten Flächen gibt.
GetCurveParamsLiefert Anfangs- und Endpunkt sowie den Parameterbereich einer Teilkante.
GetEdgeLiefert die Kante, zu der eine Teilkante gehört.
GetLoopLiefert die Schleife, zu der eine Teilkante gehört.
GetNextLiefert die nächste Teilkante in derselben Schleife.
GetPartnerLiefert die Partner-Teilkante, also dieselbe Kante in der Schleife der Nachbarfläche.
GetSensePrüft, ob eine Teilkante in dieselbe Richtung läuft wie ihre Kante.

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

Siehe auch

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

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