Objekt · SldWorks
SketchRelation-Objekt
Eine Skizzenbeziehung wie horizontal, tangential oder deckungsgleich mit ihrer Art und den beteiligten Elementen.
Beschreibung
SketchRelation gibt Zugriff auf die Elemente einer Skizzenbeziehung. Du liest damit die Art der Beziehung, die beteiligten Elemente und eine zugehörige Bemaßung. Außerdem unterdrückst du eine Beziehung oder ersetzt eines ihrer Elemente. Die meisten Befehle gibt es seit SOLIDWORKS 2004.
Zugriff
SketchRelationManager.GetRelations: alle Beziehungen einer Skizze, gefiltert mitswSketchRelationFilterType_e. DenSketchRelationManagerliefertSketch.RelationManager.SketchRelationManager.AddRelation: eine neue BeziehungSketchSegment.GetRelationsundSketchPoint.GetRelations: die Beziehungen eines Skizzenelements oder Skizzenpunkts
Beispiel
' Gibt für jede Beziehung der ausgewählten Skizze Art, Zahl der Elemente,
' Bemaßung und Unterdrückung aus.
' Vorbedingung: Ein Teil oder eine Baugruppe ist offen, eine Skizze ist im FeatureManager ausgewählt.
' Ergebnis: Die Werte stehen im Direktfenster.
Option Explicit
Sub main()
Dim swApp As SldWorks.SldWorks
Dim swModel As SldWorks.ModelDoc2
Dim swSel As Object
Dim swFeat As SldWorks.Feature
Dim swSketch As SldWorks.Sketch
Dim swRelMgr As SldWorks.SketchRelationManager
Dim swRel As SldWorks.SketchRelation
Dim swDispDim As SldWorks.DisplayDimension
Dim vBeziehungen As Variant
Dim i As Long
Set swApp = Application.SldWorks
Set swModel = swApp.ActiveDoc
If swModel Is Nothing Then Exit Sub
Set swSel = swModel.SelectionManager.GetSelectedObject6(1, -1)
If Not TypeOf swSel Is SldWorks.Feature Then Exit Sub
Set swFeat = swSel
Set swSketch = swFeat.GetSpecificFeature2
If swSketch Is Nothing Then Exit Sub
Set swRelMgr = swSketch.RelationManager
vBeziehungen = swRelMgr.GetRelations(swAll)
If IsEmpty(vBeziehungen) Then Exit Sub
For i = 0 To UBound(vBeziehungen)
If Not vBeziehungen(i) Is Nothing Then
Set swRel = vBeziehungen(i)
Debug.Print "Beziehung " & i & ": Art " & swRel.GetRelationType & _
", " & swRel.GetEntitiesCount & " Elemente" & _
IIf(swRel.Suppressed, ", unterdrückt", "")
Set swDispDim = swRel.GetDisplayDimension
If Not swDispDim Is Nothing Then Debug.Print " Bemaßung " & swDispDim.GetNameForSelection
End If
Next i
End SubBemerkungen
Elemente: SOLIDWORKS legt für eine Beziehung manchmal ein internes Element an. Wählst du etwa einen Punkt und eine Kante, entsteht unter Umständen ein Skizzenelement. SketchRelation.GetEntities liefert dann den Punkt und dieses Skizzenelement. Die tatsächlich gewählten Elemente, etwa die Fläche bei einer Beziehung swConstraintType_OFFSETEDGE, liefert SketchRelation.GetDefinitionEntities2. Einzelne Einträge der Arrays können leer sein, prüf sie deshalb mit Is Nothing.
Arten der Elemente: SketchRelation.GetEntitiesType liefert zu jedem Element einen Wert aus swSketchRelationEntityTypes_e. Danach weist du das Element etwa einer Variablen vom Typ SketchPoint oder SketchSegment zu.
Ändern: SketchRelation.ReplaceEntity braucht eine Skizze im Bearbeitungsmodus. Für SketchRelation.Suppressed sagt die Hilfe das nicht.
Veraltet: GetDefinitionEntities ist durch SketchRelation.GetDefinitionEntities2 ersetzt.
Eigenschaften und Methoden
Eigenschaften 1, davon 1 beschrieben
| Name | Beschreibung |
|---|---|
| Suppressed | Liest oder setzt, ob die Skizzenbeziehung unterdrückt ist. |
Methoden 8, davon 7 beschrieben, 1 veraltet
| Name | Beschreibung |
|---|---|
| GetDefinitionEntities | veraltet ersetzt durch SketchRelation.GetDefinitionEntities2 |
| GetDefinitionEntities2 | Liefert die Elemente, mit denen die Skizzenbeziehung tatsächlich angelegt wurde. |
| GetDisplayDimension | Liefert die Bemaßung, die zur Skizzenbeziehung gehört. |
| GetEntities | Liefert die Elemente der Skizzenbeziehung. |
| GetEntitiesCount | Liefert die Zahl der Elemente der Skizzenbeziehung. |
| GetEntitiesType | Liefert die Arten der Elemente der Skizzenbeziehung, etwa Punkt, Linie oder Bogen. |
| GetRelationType | Liefert die Art der Skizzenbeziehung, etwa horizontal, tangential oder deckungsgleich. |
| ReplaceEntity | Ersetzt ein Element der Skizzenbeziehung durch ein anderes. |
Nicht aufgeführt sind 4 C++-Varianten (Namen mit I davor, zum Beispiel IGetDefinitionEntities). In VBA nimmst du immer den Befehl ohne I.
Siehe auch
Englisches Original: ISketchRelation in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.