SolidWorksMakroprogrammierung

Objekt · SldWorks

SFSymbol-Objekt

Ein Oberflächensymbol als Beschriftung: Symbolart, Rillen- und Profilrichtung, Texte wie Rauheitswerte, Ausrichtung und die Geometrie seiner Darstellung.

Deklaration Dim x As SldWorks.SFSymbol · in der englischen .NET-Hilfe: ISFSymbol

Beschreibung

SFSymbol gibt Zugriff auf die Anzeige von Oberflächensymbolen (surface finish symbols). Ein Oberflächensymbol hat eine Symbolart, etwa Grundsymbol oder Materialabtrag gefordert, dazu Textfelder wie Rauheitswerte, Fertigungsverfahren und Bearbeitungszugabe, eine Rillenrichtung und eine Ausrichtung. Wo die Hilfe eine Version nennt, ist es SOLIDWORKS 99 bis 2006. ProfileDirection und ProfileAngle kamen mit SOLIDWORKS 2025 SP03 dazu.

Zugriff

Beispiel

' Gibt für jedes Oberflächensymbol der ausgewählten Zeichenansicht Art, ersten Rauheitswert
' und Rillenrichtung aus und setzt die Rillenrichtung auf senkrecht.
' Vorbedingung: Eine Zeichnung ist offen, eine Zeichenansicht mit Oberflächensymbolen ist ausgewählt.
' Ergebnis:     Die Werte stehen im Direktfenster, die Symbole zeigen die Rillenrichtung senkrecht.
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swView As SldWorks.View
    Dim swSF As SldWorks.SFSymbol
    Dim swSel As Object
    Dim vBereich As Variant

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

    Set swSF = swView.GetFirstSFSymbol
    Do While Not swSF Is Nothing
        Debug.Print "Art " & swSF.GetSymbol & ", Rauheit " & swSF.GetText(swSFSymbolRoughnessValue1) & _
                    ", Rillenrichtung " & swSF.GetDirectionOfLay
        If False = swSF.SetDirectionOfLay(swSFPerp) Then Debug.Print "  Rillenrichtung nicht geändert"
        Set swSF = swSF.GetNext
    Loop
    swModel.ActiveView.GraphicsRedraw vBereich        ' leer: ganzes Fenster
End Sub

Bemerkungen

Neu zeichnen: Nach SFSymbol.SetText und SFSymbol.SetDirectionOfLay musst du das Fenster neu zeichnen. Die Hilfe verweist dafür auf das veraltete ModelDoc2.GraphicsRedraw2, aktuell ist ModelView.GraphicsRedraw.

Darstellung: Die Befehle für Linien, Bögen, Dreiecke, Pfeilspitzen und Textstücke beschreiben, wie SOLIDWORKS das Symbol zeichnet. Die Einheit der Koordinaten nennt die Hilfe nicht; es sind wie sonst in der API Meter. Nur bei SFSymbol.GetTextHeightAtIndex nennt sie Meter, bei SFSymbol.GetTextAngleAtIndex und SFSymbol.SetAngle Bogenmaß.

Beschriftung: Allgemeine Dinge wie Lage, Ebene oder Sichtbarkeit stellst du über die Annotation aus SFSymbol.GetAnnotation ein.

Hilfebeispiele: Zu SFSymbol selbst gibt es nur das allgemeine Beispiel „Get Annotation Object“.

Ein mit ModelDocExtension.InsertSurfaceFinishSymbol3 angelegter Rauheitswert steht nicht unter swSFSymbolRoughnessValue1, SFSymbol.GetText liefert dafür einen leeren Text.

Eigenschaften und Methoden

Eigenschaften 7, davon 5 beschrieben, 2 veraltet

NameBeschreibung
GOSTDefaultSymbolLiest oder setzt, ob beim Oberflächensymbol die GOST-Option „Add default symbol“ gesetzt ist.
GOSTNotationLiest oder setzt, ob beim Oberflächensymbol die GOST-Option „Use for notation“ gesetzt ist.
Grindingveraltet ersetzt durch SFSymbol.GetSymbolSurfaceTexture
OrientationLiest oder setzt die Ausrichtung des Oberflächensymbols: waagrecht, senkrecht, im Winkel des Elements, gespiegelt oder in einem eigenen Winkel.
ProfileAngleLiest oder setzt den Winkel der Profilrichtung des Oberflächensymbols.
ProfileDirectionLiest oder setzt die Profilrichtung des Oberflächensymbols: keine, senkrecht, parallel, kreisförmig oder unter einem Winkel.
Rotatedveraltet ersetzt durch SFSymbol.Orientation

Methoden 35, davon 33 beschrieben, 2 veraltet

NameBeschreibung
GetAngleLiefert den Winkel des Oberflächensymbols.
GetAnnotationLiefert die Beschriftung (Annotation), zu der das Oberflächensymbol gehört.
GetArcAtIndexLiefert Linientyp, Anfangs-, End- und Mittelpunkt und Drehsinn eines Bogens in der Darstellung des Oberflächensymbols.
GetArcCountLiefert die Zahl der Bögen in der Darstellung des Oberflächensymbols.
GetArrowHeadAtIndexLiefert Spitze, Richtung, Maße und Art einer Pfeilspitze in der Darstellung des Oberflächensymbols.
GetArrowHeadCountLiefert die Zahl der Pfeilspitzen in der Darstellung des Oberflächensymbols.
GetArrowHeadInfoLiefert Länge, Maße und Art der Pfeilspitze am fernen Ende der Bezugslinie.
GetDirectionOfLayLiefert die Rillenrichtung des Oberflächensymbols.
GetLeaderAtIndexLiefert die Punkte einer Bezugslinie des Oberflächensymbols.
GetLeaderCountLiefert die Zahl der Bezugslinien am Oberflächensymbol.
GetLineAtIndexLiefert Linientyp, Anfangs- und Endpunkt einer Linie in der Darstellung des Oberflächensymbols.
GetLineCountLiefert die Zahl der Linien in der Darstellung des Oberflächensymbols.
GetNextLiefert das nächste Oberflächensymbol in der Zeichenansicht.
GetSymbolLiefert die Art des Oberflächensymbols, etwa Grundsymbol oder Materialabtrag gefordert.
GetSymbolAllAroundLiefert, ob das Oberflächensymbol für ringsum oder nur örtlich gilt.
GetSymbolSurfaceTextureLiefert die Oberflächenstufe nach JIS eines Oberflächensymbols.
GetSymbolTypeveraltet ersetzt durch SFSymbol.GetSymbol
GetTextLiefert ein Textfeld des Oberflächensymbols, etwa einen Rauheitswert oder das Fertigungsverfahren.
GetTextAngleAtIndexLiefert den Winkel eines Textstücks in der Darstellung des Oberflächensymbols.
GetTextAtIndexLiefert ein Textstück aus der Darstellung des Oberflächensymbols.
GetTextCountLiefert die Zahl der Textstücke in der Darstellung des Oberflächensymbols.
GetTextFontAtIndexLiefert die Schriftart eines Textstücks in der Darstellung des Oberflächensymbols.
GetTextHeightAtIndexLiefert die Schrifthöhe eines Textstücks in der Darstellung des Oberflächensymbols.
GetTextInvertAtIndexLiefert, ob ein Textstück in der Darstellung des Oberflächensymbols an der X-Achse gespiegelt ist.
GetTextPositionAtIndexLiefert die Lage eines Textstücks relativ zum Ursprung des Oberflächensymbols.
GetTextRefPositionAtIndexLiefert, auf welchen Punkt eines Textstücks sich seine Lage bezieht, etwa oben links oder Mitte.
GetTriangleAtIndexLiefert die Eckpunkte, die Füllung und den Linientyp eines Dreiecks in der Darstellung des Oberflächensymbols.
GetTriangleCountLiefert die Zahl der Dreiecke in der Darstellung des Oberflächensymbols.
HasExtraLeaderLiefert, ob die Bezugslinie des Oberflächensymbols geknickt ist, also eine zusätzliche Linie hat.
IsAttachedLiefert, ob das Oberflächensymbol mit einer Bezugslinie angehängt ist.
SetAngleSetzt einen eigenen Winkel für das Oberflächensymbol.
SetDirectionOfLaySetzt die Rillenrichtung des Oberflächensymbols.
SetSymbolSetzt die Art des Oberflächensymbols, dazu die Oberflächenstufe nach JIS oder ob es ringsum gilt.
SetSymbolTypeveraltet ersetzt durch SFSymbol.SetSymbol
SetTextSetzt ein Textfeld des Oberflächensymbols, etwa einen Rauheitswert oder das Fertigungsverfahren.

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

Siehe auch

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

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