Objekt · SldWorks
FaceHatch-Objekt
Eine Flächenschraffur, die SOLIDWORKS in Schnitt-, Detail- und unterbrochenen Ansichten selbst setzt: Muster, Winkel, Maßstab, Füllung, Farbe, Layer und die geschnittene Fläche.
Beschreibung
FaceHatch steht für eine Schraffur, die SOLIDWORKS automatisch hinzufügt, wenn du eine Schnittansicht, eine ausgerichtete Schnittansicht, eine unterbrochene Ansicht oder eine Detailansicht erstellst. Eine Bereichsschraffur, die du selbst auf eine Fläche oder Skizze setzt, ist dagegen eine SketchHatch. Die meisten Befehle gibt es seit SOLIDWORKS 2003, FaceHatch.HatchType und FaceHatch.HatchScope seit SOLIDWORKS 2020.
Zugriff
View.GetFaceHatches: alle Flächenschraffuren einer Zeichenansicht, die Zahl liefert vorherView.GetFaceHatchCount
Die Ansichten einer Zeichnung gehst du mit DrawingDoc.GetFirstView und View.GetNextView durch.
Beispiel
' Gibt für jede Flächenschraffur der ausgewählten Zeichenansicht Art, Muster,
' Winkel, Maßstab, Geltungsbereich, Layer und den Körper der Fläche aus.
' Vorbedingung: Eine Zeichnung ist offen, eine Schnittansicht ist ausgewählt.
' Ergebnis: Die Werte stehen im Direktfenster, die Zeichnung bleibt unverändert.
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 swSchraffur As SldWorks.FaceHatch
Dim swFace As SldWorks.Face2
Dim vSchraffuren As Variant
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
If swView.GetFaceHatchCount = 0 Then
Debug.Print swView.GetName2 & ": keine Flächenschraffuren"
Exit Sub
End If
vSchraffuren = swView.GetFaceHatches
For i = 0 To UBound(vSchraffuren)
Set swSchraffur = vSchraffuren(i)
Select Case swSchraffur.HatchType
Case swAreaHatchFillStyle_Pattern
Debug.Print "Schraffur " & i + 1 & ": Muster " & swSchraffur.Pattern & ", Winkel " & _
Round(swSchraffur.Angle * 180 / PI, 1) & "°, Maßstab " & swSchraffur.Scale2
Case swAreaHatchFillStyle_Solid
Debug.Print "Schraffur " & i + 1 & ": flächig gefüllt"
Case Else
Debug.Print "Schraffur " & i + 1 & ": keine Füllung"
End Select
Debug.Print " Geltungsbereich " & swSchraffur.HatchScope & ", Material: " & swSchraffur.UseMaterialHatch & _
", Layer: " & swSchraffur.Layer
Set swFace = swSchraffur.Face
If Not swFace Is Nothing Then Debug.Print " Körper: " & swFace.GetBody.Name
Next i
End SubBemerkungen
Hilfebeispiele: „Get Face Hatch Data“ gibt für die ausgewählte Schnittansicht A-A der Zeichnung bolt-assembly.slddrw Winkel, Farbe, Definition, Layer, Muster, Maßstab, Füllung und Materialschraffur jeder Flächenschraffur aus. „Get Crosshatches on View“ geht alle Ansichten durch und zählt die Schraffuren mit View.GetFaceHatchCount. „Get Hatching Data“ liest Flächenschraffuren und Bereichsschraffuren nebeneinander und holt dabei mit FaceHatch.Face die Fläche.
Nur lesbar? In den Remarks zu FaceHatch steht, das Objekt sei nur lesbar. Die Seiten der einzelnen Befehle geben aber an, dass du FaceHatch.Angle, FaceHatch.Scale2, FaceHatch.HatchType, FaceHatch.HatchScope und FaceHatch.UseMaterialHatch auch setzen kannst. Ob das Setzen wirkt, ist deshalb nicht sicher.
Vollfüllungen: Für Vollfüllungen in Detailansichten, unterbrochenen und abgeschnittenen Ansichten nennt die Hilfe eigene Befehle: View.GetSolidHatchCount und View.GetSolidHatchInfo.
Veralteter Befehl: FaceHatch.Scale ist veraltet, an seine Stelle tritt FaceHatch.Scale2.
Eigenschaften und Methoden
Eigenschaften 13, davon 12 beschrieben, 1 veraltet
| Name | Beschreibung |
|---|---|
| Angle | Liest oder setzt den Winkel des Schraffurmusters im Bogenmaß. |
| Color | Liefert die Farbe der Flächenschraffur. |
| Definition | Liefert die Definition der Flächenschraffur als Text. |
| Face | Liefert die Fläche im Modell, zu der die Flächenschraffur gehört. |
| HatchScope | Liest oder setzt, für welchen Bereich die Flächenschraffur gilt: einzelner Bereich, Komponente, Körper oder ganze Ansicht. |
| HatchType | Liest oder setzt die Art der Flächenschraffur: Muster, flächige Füllung oder keine. |
| Layer | Liefert den Layer der Komponente, an der die Flächenschraffur hängt. |
| Pattern | Liefert den Namen des Schraffurmusters. |
| PatternId | Liefert die Kennung des Schraffurmusters aus der Datei SLDWRKS.PTN. |
| Scale | veraltet ersetzt durch FaceHatch.Scale2 |
| Scale2 | Liest oder setzt den Maßstab des Schraffurmusters. |
| SolidFill | Liefert, ob die Flächenschraffur flächig in einer Farbe gefüllt ist. |
| UseMaterialHatch | Liest oder setzt, ob die Flächenschraffur die Schraffur aus dem Material nimmt. |
Siehe auch
Englisches Original: IFaceHatch in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.