SolidWorksMakroprogrammierung

Objekt · SldWorks

Edge-Objekt

Steht für eine Kante eines Körpers: ihre Kurve, Länge, Endpunkte und die angrenzenden Flächen.

Deklaration Dim x As SldWorks.Edge · in der englischen .NET-Hilfe: IEdge

Beschreibung

Eine Kante ist die Grenze zwischen zwei Flächen eines Körpers, bei Flächenkörpern auch der freie Rand einer einzigen Fläche. Ihre Form beschreibt die zugrunde liegende Curve, die du mit Edge.GetCurve holst. Wo die Kante auf dieser Kurve anfängt und aufhört, liefert Edge.GetCurveParams3.

Zugriff

Beispiel

' Gibt Länge und Kurventyp der ausgewählten Kante aus.
' Vorbedingung: In einem Teil ist eine Kante ausgewählt.
' Ergebnis:     Zeile im Direktfenster (Strg+G).
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swSelMgr As SldWorks.SelectionMgr
    Dim swEdge As SldWorks.Edge
    Dim swCurve As SldWorks.Curve
    Dim swParam As SldWorks.CurveParamData
    Dim dLaenge 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) <> swSelEDGES Then
        swApp.SendMsgToUser2 "Bitte zuerst eine Kante auswählen.", swMbWarning, swMbOk
        Exit Sub
    End If
    Set swEdge = swSelMgr.GetSelectedObject6(1, -1)

    Set swCurve = swEdge.GetCurve
    Set swParam = swEdge.GetCurveParams3
    dLaenge = swCurve.GetLength3(swParam.UMinValue, swParam.UMaxValue)
    Debug.Print "Länge: " & Format(dLaenge * 1000, "0.000") & " mm" & _
        IIf(swCurve.IsLine, ", gerade", IIf(swCurve.IsCircle, ", Kreisbogen", ""))
End Sub

Bemerkungen

Zum Auswählen weist du die Kante einer Variable vom Typ SldWorks.Entity zu und rufst Entity.Select4 auf. Längen und Koordinaten sind in Metern.

Kanten haben keine natürliche Richtung. Welcher Eckpunkt Anfang und welcher Ende ist, legt die Kurve fest, und ob Kante und Kurve gleich laufen, sagt Edge.IsParamReversed. Eine feste Richtung innerhalb einer Fläche haben erst die Teilkanten (CoEdge) einer Schleife.

Eigenschaften und Methoden

Eigenschaften 1, davon 1 beschrieben

NameBeschreibung
CheckPrüft eine Kante auf Fehler und liefert die fehlerhaften Elemente.

Methoden 31, davon 27 beschrieben, 4 veraltet

NameBeschreibung
CreateWireBodyErzeugt aus einer Kante einen Drahtkörper.
DisplayZeigt eine Kante in einer eigenen Farbe hervorgehoben an oder nimmt das zurück.
EdgeInFaceSensePrüft, ob eine Kante in derselben Richtung läuft wie die Schleife auf einer Fläche.
EnumCoEdgesLiefert die Teilkanten einer Kante als Aufzählung.
Evaluateveraltet ersetzt durch Edge.Evaluate2
Evaluate2Berechnet Punkt und Ableitungen einer Kante an einer Stelle ihrer Kurve.
GetBodyLiefert den Körper, zu dem eine Kante gehört.
GetClosestPointOnLiefert den Punkt einer Kante, der einem gegebenen Punkt am nächsten liegt.
GetCoEdgesLiefert die Teilkanten, die auf eine Kante verweisen.
GetCurveLiefert die Kurve, auf der eine Kante liegt.
GetCurveParamsveraltet ersetzt durch Edge.GetCurveParams3
GetCurveParams2veraltet ersetzt durch Edge.GetCurveParams3
GetCurveParams3Liefert Anfangs- und Endpunkt, Parameterbereich und Kurventyp einer Kante.
GetEndVertexLiefert den Endpunkt einer Kante.
GetIDLiefert die Kanten-ID einer Kante eines importierten Körpers.
GetParameterLiefert den Parameter U eines Punkts auf einer Kante.
GetStartVertexLiefert den Anfangspunkt einer Kante.
GetTangentEdgesLiefert alle Kanten, die tangential an eine Kante anschließen.
GetTangentEdgesCountLiefert die Anzahl der Kanten, die tangential an eine Kante anschließen.
GetTrackingIDsLiefert die Tracking-IDs einer Kante zu einer Tracking-Definition.
GetTrackingIDsCountLiefert die Anzahl der Tracking-IDs einer Kante zu einer Tracking-Definition.
GetTwoAdjacentFacesveraltet ersetzt durch Edge.GetTwoAdjacentFaces2
GetTwoAdjacentFaces2Liefert die beiden Flächen, die an eine Kante grenzen.
HighlightHebt eine Kante im Grafikbereich hervor oder nimmt die Hervorhebung zurück.
IsParamReversedPrüft, ob eine Kante entgegen der Richtung ihrer Kurve läuft.
IsTolerantPrüft, ob eine Kante tolerant ist, und liefert ihre Toleranz (den Spalt).
RemoveIdEntfernt die Kanten-ID einer Kante eines importierten Körpers.
RemoveRedundantTopologyEntfernt überflüssige Topologie an einer Kante.
RemoveTrackingIDEntfernt die Tracking-ID einer Kante zu einer Tracking-Definition.
SetIdSetzt die Kanten-ID einer Kante eines importierten Körpers.
SetTrackingIDGibt einer Kante eine eigene Tracking-ID, an der du sie nach Änderungen wiedererkennst.

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

Siehe auch

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

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