SolidWorksMakroprogrammierung

Objekt · SldWorks

SketchHatch-Objekt

Eine Bereichsschraffur in einer Zeichnung: Muster, Winkel, Maßstab, Füllung, Farbe und Layer einer Schraffur, die du selbst auf eine Fläche oder geschlossene Skizze gesetzt hast.

Deklaration Dim x As SldWorks.SketchHatch · in der englischen .NET-Hilfe: ISketchHatch

Beschreibung

SketchHatch steht für eine Bereichsschraffur, die du in einer Zeichnung mit „Einfügen > Beschriftungen > Bereichsschraffur/Füllung“ auf ein geschlossenes Skizzenprofil oder eine Fläche setzt. Die Schraffur in einem Schnitt, die SOLIDWORKS selbst setzt, ist dagegen ein FaceHatch. Die meisten Befehle gibt es seit SOLIDWORKS 2000.

Zugriff

Neu anlegen kannst du eine Schraffur mit ModelDoc2.InsertHatchedFace.

Beispiel

' Gibt für jede Bereichsschraffur der ausgewählten Zeichnungsansicht Muster, Winkel,
' Maßstab, Füllung und Layer aus.
' Vorbedingung: Eine Zeichnung ist offen, eine Zeichnungsansicht mit Bereichsschraffuren
'               ist ausgewählt.
' Ergebnis:     Die Werte stehen im Direktfenster.
Option Explicit

Sub main()
    Const PI As Double = 3.14159265358979
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swSel As Object
    Dim swView As SldWorks.View
    Dim swSketch As SldWorks.Sketch
    Dim vSchraffuren As Variant
    Dim swSchraffur As SldWorks.SketchHatch
    Dim i As Long

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Then Exit Sub
    If swModel.GetType <> swDocDRAWING Then Exit Sub
    Set swSel = swModel.SelectionManager.GetSelectedObject6(1, -1)
    If Not TypeOf swSel Is SldWorks.View Then Exit Sub
    Set swView = swSel
    Set swSketch = swView.GetSketch

    vSchraffuren = swSketch.GetSketchHatches
    If IsEmpty(vSchraffuren) Then
        Debug.Print swView.GetName2 & ": keine Bereichsschraffuren"
        Exit Sub
    End If
    For i = 0 To UBound(vSchraffuren)
        Set swSchraffur = vSchraffuren(i)
        If swSchraffur.SolidFill Then
            Debug.Print "Schraffur " & i & ": flächig gefüllt"
        Else
            Debug.Print "Schraffur " & i & ": Muster " & swSchraffur.Pattern & ", Winkel " & _
                        Round(swSchraffur.Angle * 180 / PI, 1) & "°, Maßstab " & swSchraffur.Scale2
        End If
        If swSchraffur.Layer <> "" Then Debug.Print "  Layer " & swSchraffur.Layer
    Next i
End Sub

Bemerkungen

Skizze bearbeiten: Die Hilfebeispiele „Get Area Hatch Data“ und „Override Layer Color for Area Hatch“ rufen vor Sketch.GetSketchHatches ModelDoc2.EditSketch auf, das Hilfebeispiel „Get Hatching Data“ nicht. Dort steht allerdings der Tippfehler GetSelectedObjec6 statt GetSelectedObject6, so läuft es nicht. Ob die Skizze der Ansicht dafür bearbeitet werden muss, sagt die Hilfe nicht. Für das Auswählen und Abwählen spielt es eine Rolle (siehe SketchHatch.DeSelect).

Layer: Layer gibt es nur in Zeichnungen. Liegt die Schraffur auf einem Layer, übernimmt sie dessen Farbe, solange du sie nicht mit SketchHatch.Color änderst. SketchHatch.LayerOverride zeigt, ob die Farbe abweicht.

Veraltete Befehle: Scale, Select, Select2, Select3 und SelectByMark sind veraltet. An ihre Stelle treten SketchHatch.Scale2 und SketchHatch.Select4.

Eigenschaften und Methoden

Eigenschaften 9, davon 8 beschrieben, 1 veraltet

NameBeschreibung
AngleLiest oder setzt den Winkel des Schraffurmusters im Bogenmaß.
ColorLiest oder setzt die Linienfarbe der Schraffur.
LayerLiest oder setzt den Layer der Schraffur.
LayerOverrideLiest oder setzt, welche Eigenschaften der Schraffur vom Layer abweichen. Bei Schraffuren ist das nur die Farbe.
PatternLiest oder setzt das Schraffurmuster über seinen Namen, etwa "Stars" oder "Honeycomb".
PatternIdLiefert die Kennung des Schraffurmusters aus der Datei SLDWRKS.PTN.
Scaleveraltet ersetzt durch SketchHatch.Scale2
Scale2Liest oder setzt den Maßstab des Schraffurmusters.
SolidFillLiest oder setzt, ob die Schraffur flächig gefüllt ist statt mit einem Muster.

Methoden 9, davon 5 beschrieben, 4 veraltet

NameBeschreibung
DeSelectWählt die Schraffur ab.
GetFaceLiefert die Fläche, die die Schraffur ausfüllt, als vorübergehende Fläche für die Geometrie.
GetIDLiefert die Kennung der Schraffur innerhalb ihrer Skizze als Paar aus zwei Zahlen.
GetSketchLiefert die Skizze, zu der die Schraffur gehört.
Selectveraltet ersetzt durch SketchHatch.Select4
Select2veraltet ersetzt durch SketchHatch.Select4
Select3veraltet ersetzt durch SketchHatch.Select4
Select4Wählt die Schraffur aus, allein oder zusätzlich zur bisherigen Auswahl, auf Wunsch mit einer Markierung.
SelectByMarkveraltet ersetzt durch SketchHatch.Select4

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

Siehe auch

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

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