SolidWorksMakroprogrammierung

Objekt · SldWorks

SketchRelationManager-Objekt

Verwaltet die Beziehungen einer Skizze: lesen, zählen, anlegen und löschen.

Deklaration Dim x As SldWorks.SketchRelationManager · in der englischen .NET-Hilfe: ISketchRelationManager

Beschreibung

SketchRelationManager gibt Zugriff auf alle Beziehungen einer Skizze. Zu jeder Beziehung bekommst du die beteiligten Elemente und umgekehrt. Du liest die Beziehungen gefiltert aus, legst neue an, prüfst, welche Beziehungen für bestimmte Elemente möglich sind, und löschst Beziehungen. Die Befehle gibt es seit SOLIDWORKS 2004.

Zugriff

Beispiel

' Legt in einer neuen Skizze auf der Ebene "Ebene vorne" zwei Linien an, gibt die möglichen
' Beziehungen für beide aus und macht sie parallel.
' Vorbedingung: Ein Teil ist offen, keine Skizze ist in Bearbeitung.
' Ergebnis:     Die neue Skizze enthält zwei parallele Linien, die Werte stehen im Direktfenster.
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swSketchMgr As SldWorks.SketchManager
    Dim swRelMgr As SldWorks.SketchRelationManager
    Dim swRel As SldWorks.SketchRelation
    Dim vElemente(1) As Object
    Dim vArten As Variant
    Dim i As Long

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Then Exit Sub
    If False = swModel.Extension.SelectByID2("Ebene vorne", "PLANE", 0, 0, 0, False, 0, Nothing, 0) Then Exit Sub
    Set swSketchMgr = swModel.SketchManager
    swSketchMgr.InsertSketch True
    Set vElemente(0) = swSketchMgr.CreateLine(0, 0, 0, 0.05, 0.01, 0)
    Set vElemente(1) = swSketchMgr.CreateLine(0, 0.03, 0, 0.05, 0.05, 0)
    swModel.ClearSelection2 True

    Set swRelMgr = swSketchMgr.ActiveSketch.RelationManager
    vArten = swRelMgr.GetAllowedRelations(vElemente)
    If IsArray(vArten) Then
        For i = 0 To UBound(vArten)
            Debug.Print "Möglich: Art " & vArten(i)            ' swConstraintType_e
        Next i
    End If

    Set swRel = swRelMgr.AddRelation(vElemente, swConstraintType_PARALLEL)
    If swRel Is Nothing Then Debug.Print "Keine Beziehung angelegt"
    Debug.Print swRelMgr.GetRelationsCount(swAll) & " Beziehungen in der Skizze"
    swSketchMgr.InsertSketch True
End Sub

Bemerkungen

Aktive Skizze: SketchRelationManager.AddRelation wirkt nur, wenn eine Skizze aktiv ist. Ob eine Skizze aktiv ist, prüfst du mit SketchManager.ActiveSketch. Für die übrigen Befehle sagt die Hilfe das nicht.

Leere Einträge: Einträge im Array von SketchRelationManager.GetRelations können leer sein. Prüf deshalb jeden mit Is Nothing.

Logische Beziehungen: Die Befehle zum Löschen sprechen von „logischen“ Beziehungen. Was genau dazu zählt, etwa ob Bemaßungen ausgenommen sind, sagt die Hilfe nicht.

Elemente als Array: AddRelation und GetAllowedRelations erwarten ein Array von Elementen. Welche Objekte erlaubt sind, nennt die Hilfe nicht. Skizzenelemente (SketchSegment) gehen, vermutlich auch Skizzenpunkte (SketchPoint). Die Hilfe hat zu beiden Befehlen kein Beispiel.

Eigenschaften und Methoden

Methoden 6, davon 6 beschrieben

NameBeschreibung
AddRelationLegt in der aktiven Skizze eine Beziehung zwischen den angegebenen Elementen an.
DeleteAllRelationsLöscht alle logischen Beziehungen der Skizze.
DeleteRelationLöscht eine Beziehung der Skizze.
GetAllowedRelationsLiefert die Arten von Beziehungen, die für die angegebenen Elemente möglich sind.
GetRelationsLiefert die Beziehungen der Skizze, gefiltert etwa nach hängenden oder überbestimmenden Beziehungen.
GetRelationsCountLiefert die Zahl der Beziehungen der Skizze, gefiltert etwa nach hängenden oder überbestimmenden Beziehungen.

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

Siehe auch

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

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