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.
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
Sketch.GetSketchHatches: alle Schraffuren einer Skizze, in einer Zeichnungsansicht überView.GetSketchLayer.GetItemsundEnumSketchHatches.Next: weitere Wege
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 SubBemerkungen
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
| Name | Beschreibung |
|---|---|
| Angle | Liest oder setzt den Winkel des Schraffurmusters im Bogenmaß. |
| Color | Liest oder setzt die Linienfarbe der Schraffur. |
| Layer | Liest oder setzt den Layer der Schraffur. |
| LayerOverride | Liest oder setzt, welche Eigenschaften der Schraffur vom Layer abweichen. Bei Schraffuren ist das nur die Farbe. |
| Pattern | Liest oder setzt das Schraffurmuster über seinen Namen, etwa "Stars" oder "Honeycomb". |
| PatternId | Liefert die Kennung des Schraffurmusters aus der Datei SLDWRKS.PTN. |
| Scale | veraltet ersetzt durch SketchHatch.Scale2 |
| Scale2 | Liest oder setzt den Maßstab des Schraffurmusters. |
| SolidFill | Liest oder setzt, ob die Schraffur flächig gefüllt ist statt mit einem Muster. |
Methoden 9, davon 5 beschrieben, 4 veraltet
| Name | Beschreibung |
|---|---|
| DeSelect | Wählt die Schraffur ab. |
| GetFace | Liefert die Fläche, die die Schraffur ausfüllt, als vorübergehende Fläche für die Geometrie. |
| GetID | Liefert die Kennung der Schraffur innerhalb ihrer Skizze als Paar aus zwei Zahlen. |
| GetSketch | Liefert die Skizze, zu der die Schraffur gehört. |
| Select | veraltet ersetzt durch SketchHatch.Select4 |
| Select2 | veraltet ersetzt durch SketchHatch.Select4 |
| Select3 | veraltet ersetzt durch SketchHatch.Select4 |
| Select4 | Wählt die Schraffur aus, allein oder zusätzlich zur bisherigen Auswahl, auf Wunsch mit einer Markierung. |
| SelectByMark | veraltet 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.