SolidWorksMakroprogrammierung

Objekt · SldWorks

SketchRegion-Objekt

Ein Bereich einer Skizze: eine von Skizzenelementen umschlossene Fläche mit ihren Kanten und Schleifen.

Deklaration Dim x As SldWorks.SketchRegion · in der englischen .NET-Hilfe: ISketchRegion

Beschreibung

Ein Skizzenbereich ist eine freie Fläche in einer Skizze, die von Skizzenelementen oder Teilen davon begrenzt wird und so im Grunde eine Fläche bildet. Auch eine Mittellinie in der Skizze teilt Bereiche ab. Einzelne Bereiche wählst du etwa aus, um nur sie zu extrudieren. Die Befehle gibt es seit SOLIDWORKS 2003, GetFirstLoop seit 2009.

Zugriff

Beispiel

' Gibt für jeden Bereich der Skizze "Skizze1" die Schleifen mit Zahl der Kanten aus
' und wählt den ersten Bereich aus.
' Vorbedingung: Ein Teil mit der Skizze "Skizze1" ist offen, die Skizze hat Bereiche.
' Ergebnis:     Die Werte stehen im Direktfenster, der erste Bereich ist ausgewählt.
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 swBereich As SldWorks.SketchRegion
    Dim swSchleife As SldWorks.Loop2
    Dim swSelData As SldWorks.SelectData
    Dim vBereiche As Variant
    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("Skizze1")
    If swFeat Is Nothing Then Exit Sub
    Set swSketch = swFeat.GetSpecificFeature2

    vBereiche = swSketch.GetSketchRegions
    If Not IsArray(vBereiche) Then Exit Sub
    For i = 0 To UBound(vBereiche)
        Set swBereich = vBereiche(i)
        Debug.Print "Bereich " & i & ": " & swBereich.GetEdgesCount & " Kanten"
        j = 0
        Set swSchleife = swBereich.GetFirstLoop
        Do While Not swSchleife Is Nothing
            Debug.Print "  Schleife " & j & ": " & swSchleife.GetEdgeCount & " Kanten, " & _
                        IIf(swSchleife.IsOuter, "außen", "innen")
            Set swSchleife = swSchleife.GetNext
            j = j + 1
        Loop
    Next i

    Set swSelData = swModel.SelectionManager.CreateSelectData
    Set swBereich = vBereiche(0)
    If False = swBereich.Select2(False, swSelData) Then Debug.Print "Auswahl fehlgeschlagen"
End Sub

Bemerkungen

Bereich oder Kontur: Neben Bereichen gibt es Skizzenkonturen (SketchContour, Sketch.GetSketchContours). Die Konturen eines Features können beides enthalten. Das Hilfebeispiel „Determine If Sketch Contour or Sketch Region“ unterscheidet sie mit TypeOf.

Kanten: SketchRegion.GetEdges liefert Edge-Objekte, keine Skizzenelemente. Was diese Kanten genau sind, etwa ob sie dauerhaft gelten, sagt die Hilfe nicht.

Auswählen: SketchRegion.Select2 ersetzt das veraltete SketchRegion.Select. Die Markierung gibst du über SelectData.Mark an.

Eigenschaften und Methoden

Eigenschaften 1, davon 1 beschrieben

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

Methoden 6, davon 5 beschrieben, 1 veraltet

NameBeschreibung
DeSelectWählt den Skizzenbereich ab.
GetEdgesLiefert die Kanten des Skizzenbereichs.
GetEdgesCountLiefert die Zahl der Kanten des Skizzenbereichs.
GetFirstLoopLiefert die erste Schleife des Skizzenbereichs.
Selectveraltet ersetzt durch SketchRegion.Select2
Select2Wählt den Skizzenbereich aus und markiert ihn.

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

Siehe auch

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

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