Objekt · SldWorks
SketchRelationManager-Objekt
Verwaltet die Beziehungen einer Skizze: lesen, zählen, anlegen und löschen.
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
Sketch.RelationManager: der SketchRelationManager einer Skizze
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 SubBemerkungen
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
| Name | Beschreibung |
|---|---|
| AddRelation | Legt in der aktiven Skizze eine Beziehung zwischen den angegebenen Elementen an. |
| DeleteAllRelations | Löscht alle logischen Beziehungen der Skizze. |
| DeleteRelation | Löscht eine Beziehung der Skizze. |
| GetAllowedRelations | Liefert die Arten von Beziehungen, die für die angegebenen Elemente möglich sind. |
| GetRelations | Liefert die Beziehungen der Skizze, gefiltert etwa nach hängenden oder überbestimmenden Beziehungen. |
| GetRelationsCount | Liefert 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.