SolidWorksMakroprogrammierung

Objekt · SldWorks

SketchPath-Objekt

Ein Skizzenpfad: eine Kette von Skizzenelementen, die als Ganzes gewählt, gemessen und mit Beziehungen versehen wird.

Deklaration Dim x As SldWorks.SketchPath · in der englischen .NET-Hilfe: ISketchPath

Beschreibung

SketchPath gibt Zugriff auf die Pfade in einer Skizze. Einen Skizzenpfad legst du mit SketchManager.MakeSketchChain aus ausgewählten Skizzenelementen an. Danach kannst du ihn als Ganzes auswählen, seine Länge abfragen und Beziehungen zu anderen Skizzenelementen hinzufügen, etwa tangential. Die Befehle gibt es seit SOLIDWORKS 2007 SP04.

Zugriff

Beispiel

' Gibt für jeden Skizzenpfad der offenen Skizze Länge, Zahl der Elemente und die
' Namen der Beziehungen aus.
' Vorbedingung: Eine Skizze mit mindestens einem Skizzenpfad ist zum Bearbeiten offen.
' Ergebnis:     Die Werte stehen im Direktfenster.
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swSketch As SldWorks.Sketch
    Dim vPfade As Variant
    Dim vNamen As Variant
    Dim swPfad As SldWorks.SketchPath
    Dim i As Long, j As Long

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Then Exit Sub
    Set swSketch = swModel.SketchManager.ActiveSketch
    If swSketch Is Nothing Then Exit Sub

    vPfade = swSketch.GetSketchPaths
    If Not IsArray(vPfade) Then Exit Sub
    For i = 0 To UBound(vPfade)
        Set swPfad = vPfade(i)
        Debug.Print "Pfad " & i & ": " & swPfad.GetSketchSegmentCount & " Elemente, Länge " & _
                    Format(swPfad.GetLength * 1000, "0.00") & " mm"
        vNamen = swPfad.GetConstraints
        If Not IsEmpty(vNamen) Then
            For j = 0 To UBound(vNamen)
                Debug.Print "  Beziehung " & vNamen(j)
            Next j
        End If
    Next i
End Sub

Bemerkungen

Anlegen: Das Hilfebeispiel „Create Sketch Path“ zeichnet vier Linien, öffnet die Skizze mit ModelDoc2.EditSketch, wählt alle Skizzenelemente mit SketchSegment.Select4 aus und ruft SketchManager.MakeSketchChain auf. Dann fügt es mit ModelDoc2.SketchAddConstraints eine Tangentialbeziehung zwischen einem Kreis und einer Linie des Pfads hinzu und liest die Werte des Pfads.

Länge: Eine Einheit für SketchPath.GetLength nennt die Hilfe nicht. Es sind Meter wie bei SketchSegment.GetLength. Das Hilfebeispiel vergleicht die Länge mit der Summe der Längen der Elemente ohne Konstruktionsgeometrie und Text.

Zählbefehle: Die Count-Methoden sind für die C++-Varianten gedacht. In VBA nimmst du die Arrays direkt.

Eigenschaften und Methoden

Methoden 9, davon 9 beschrieben

NameBeschreibung
GetConstraintsLiefert die Namen der Beziehungen des Skizzenpfads, etwa sgTANGENT.
GetConstraintsCountLiefert die Zahl der Beziehungen des Skizzenpfads.
GetLengthLiefert die Länge des Skizzenpfads.
GetRelationsLiefert die Beziehungen des Skizzenpfads als SketchRelation-Objekte.
GetRelationsCountLiefert die Zahl der Beziehungen des Skizzenpfads.
GetSketchLiefert die Skizze, in der der Skizzenpfad liegt.
GetSketchSegmentCountLiefert die Zahl der Skizzenelemente im Skizzenpfad.
GetSketchSegmentsLiefert die Skizzenelemente im Skizzenpfad.
SelectWählt den Skizzenpfad aus, allein oder zusätzlich zur bisherigen Auswahl.

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

Siehe auch

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

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