SolidWorksMakroprogrammierung

Objekt · SldWorks

SketchRelation-Objekt

Eine Skizzenbeziehung wie horizontal, tangential oder deckungsgleich mit ihrer Art und den beteiligten Elementen.

Deklaration Dim x As SldWorks.SketchRelation · in der englischen .NET-Hilfe: ISketchRelation

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

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 Sub

Bemerkungen

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

NameBeschreibung
SuppressedLiest oder setzt, ob die Skizzenbeziehung unterdrückt ist.

Methoden 8, davon 7 beschrieben, 1 veraltet

NameBeschreibung
GetDefinitionEntitiesveraltet ersetzt durch SketchRelation.GetDefinitionEntities2
GetDefinitionEntities2Liefert die Elemente, mit denen die Skizzenbeziehung tatsächlich angelegt wurde.
GetDisplayDimensionLiefert die Bemaßung, die zur Skizzenbeziehung gehört.
GetEntitiesLiefert die Elemente der Skizzenbeziehung.
GetEntitiesCountLiefert die Zahl der Elemente der Skizzenbeziehung.
GetEntitiesTypeLiefert die Arten der Elemente der Skizzenbeziehung, etwa Punkt, Linie oder Bogen.
GetRelationTypeLiefert die Art der Skizzenbeziehung, etwa horizontal, tangential oder deckungsgleich.
ReplaceEntityErsetzt 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.