SolidWorksMakroprogrammierung

Objekt · SldWorks

SketchContour-Objekt

Eine Kontur in einer Skizze: eine Folge von Skizzenelementen, die an ihren Endpunkten verbunden sind, offen oder geschlossen.

Deklaration Dim x As SldWorks.SketchContour · in der englischen .NET-Hilfe: ISketchContour

Beschreibung

Eine Kontur ist eine Folge von Skizzenelementen, die an ihren Endpunkten verbunden sind. Ob sie eine Fläche bildet, hängt davon ab, ob die Elemente einen geschlossenen Bereich umschließen. Mit Konturen legst du zum Beispiel fest, welche Bereiche einer Skizze eine Extrusion nutzt. Die Befehle gibt es seit SOLIDWORKS 2003.

Zugriff

Beispiel

' Gibt für jede Kontur der Skizze "Sketch1" aus, ob sie geschlossen ist und aus
' welchen Skizzenelementen sie besteht.
' Vorbedingung: Ein Teil mit der Skizze "Sketch1" ist offen.
' Ergebnis:     Die Werte stehen im Direktfenster.
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swPart As SldWorks.PartDoc
    Dim swFeat As SldWorks.Feature
    Dim swSketch As SldWorks.Sketch
    Dim vKonturen As Variant
    Dim vElemente As Variant
    Dim swKontur As SldWorks.SketchContour
    Dim swSeg As SldWorks.SketchSegment
    Dim sArten As String
    Dim i As Long, j As Long

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Then Exit Sub
    If swModel.GetType <> swDocPART Then Exit Sub
    Set swPart = swModel
    Set swFeat = swPart.FeatureByName("Sketch1")
    If swFeat Is Nothing Then Exit Sub
    Set swSketch = swFeat.GetSpecificFeature2

    vKonturen = swSketch.GetSketchContours
    If Not IsArray(vKonturen) Then Exit Sub
    For i = 0 To UBound(vKonturen)
        Set swKontur = vKonturen(i)
        vElemente = swKontur.GetSketchSegments
        sArten = ""
        For j = 0 To UBound(vElemente)
            Set swSeg = vElemente(j)
            sArten = sArten & " " & swSeg.GetType           ' swSketchSegments_e
        Next j
        Debug.Print "Kontur " & i & ": " & IIf(swKontur.IsClosed, "geschlossen", "offen") & _
                    ", " & swKontur.GetSketchSegmentsCount & " Elemente (Arten" & sArten & ")"
    Next i
End Sub

Bemerkungen

Offen oder geschlossen: Im Rückgabetext von SketchContour.IsClosed bedeutet True offen. Die Hilfebeispiele „Get Sketch Contours“ und „Create Extrude Feature Using Sketch Contours“ werten True aber als geschlossen, ebenso der Name der Methode. Das Beispiel oben folgt den Hilfebeispielen.

Auswählen: Das Hilfebeispiel „Create Extrude Feature Using Sketch Contours“ schaltet SelectionMgr.EnableContourSelection ein und wählt die Konturen mit ModelDocExtension.SelectByID2 und dem Typ SKETCHCONTOUR aus. Einzeln wählst du eine Kontur mit SketchContour.Select2 aus.

Zählbefehle: SketchContour.GetEdgesCount und SketchContour.GetSketchSegmentsCount sind für die C++-Varianten IGetEdges und IGetSketchSegments gedacht. In VBA nimmst du die Arrays aus SketchContour.GetEdges und SketchContour.GetSketchSegments.

Veraltete Befehle: Select ist veraltet. An seine Stelle tritt SketchContour.Select2.

Eigenschaften und Methoden

Eigenschaften 1, davon 1 beschrieben

NameBeschreibung
SketchLiefert die Skizze, zu der die Kontur gehört.

Methoden 8, davon 7 beschrieben, 1 veraltet

NameBeschreibung
DeSelectWählt die Kontur ab.
GetEdgesLiefert die Kanten der Kontur.
GetEdgesCountLiefert die Zahl der Kanten der Kontur.
GetSketchSegmentsLiefert die Skizzenelemente der Kontur.
GetSketchSegmentsCountLiefert die Zahl der Skizzenelemente der Kontur.
IsClosedLiefert, ob die Kontur geschlossen ist.
Selectveraltet ersetzt durch SketchContour.Select2
Select2Wählt die Kontur aus, allein oder zusätzlich zur bisherigen Auswahl, auf Wunsch mit einer Markierung.

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

Siehe auch

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

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