SolidWorksMakroprogrammierung

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.

Deklaration Dim x As SldWorks.FaceHatch · in der englischen .NET-Hilfe: IFaceHatch

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

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 Sub

Bemerkungen

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

NameBeschreibung
AngleLiest oder setzt den Winkel des Schraffurmusters im Bogenmaß.
ColorLiefert die Farbe der Flächenschraffur.
DefinitionLiefert die Definition der Flächenschraffur als Text.
FaceLiefert die Fläche im Modell, zu der die Flächenschraffur gehört.
HatchScopeLiest oder setzt, für welchen Bereich die Flächenschraffur gilt: einzelner Bereich, Komponente, Körper oder ganze Ansicht.
HatchTypeLiest oder setzt die Art der Flächenschraffur: Muster, flächige Füllung oder keine.
LayerLiefert den Layer der Komponente, an der die Flächenschraffur hängt.
PatternLiefert den Namen des Schraffurmusters.
PatternIdLiefert die Kennung des Schraffurmusters aus der Datei SLDWRKS.PTN.
Scaleveraltet ersetzt durch FaceHatch.Scale2
Scale2Liest oder setzt den Maßstab des Schraffurmusters.
SolidFillLiefert, ob die Flächenschraffur flächig in einer Farbe gefüllt ist.
UseMaterialHatchLiest 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.