Objekt · SldWorks
SketchPath-Objekt
Ein Skizzenpfad: eine Kette von Skizzenelementen, die als Ganzes gewählt, gemessen und mit Beziehungen versehen wird.
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
Sketch.GetSketchPaths: alle Skizzenpfade einer SkizzeSketchSegment.GetSketchPaths: die Skizzenpfade, zu denen ein Skizzenelement gehört
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 SubBemerkungen
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
| Name | Beschreibung |
|---|---|
| GetConstraints | Liefert die Namen der Beziehungen des Skizzenpfads, etwa sgTANGENT. |
| GetConstraintsCount | Liefert die Zahl der Beziehungen des Skizzenpfads. |
| GetLength | Liefert die Länge des Skizzenpfads. |
| GetRelations | Liefert die Beziehungen des Skizzenpfads als SketchRelation-Objekte. |
| GetRelationsCount | Liefert die Zahl der Beziehungen des Skizzenpfads. |
| GetSketch | Liefert die Skizze, in der der Skizzenpfad liegt. |
| GetSketchSegmentCount | Liefert die Zahl der Skizzenelemente im Skizzenpfad. |
| GetSketchSegments | Liefert die Skizzenelemente im Skizzenpfad. |
| Select | Wä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.