Objekt · SldWorks
SFSymbol-Objekt
Ein Oberflächensymbol als Beschriftung: Symbolart, Rillen- und Profilrichtung, Texte wie Rauheitswerte, Ausrichtung und die Geometrie seiner Darstellung.
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
ModelDocExtension.InsertSurfaceFinishSymbol3: fügt ein Oberflächensymbol einView.GetFirstSFSymbolmitSFSymbol.GetNextoderView.GetSFSymbols: die Oberflächensymbole einer ZeichenansichtAnnotation.GetSpecificAnnotation: bei einer Beschriftung der ArtswSFSymbol(swAnnotationType_e)
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 SubBemerkungen
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
| Name | Beschreibung |
|---|---|
| GOSTDefaultSymbol | Liest oder setzt, ob beim Oberflächensymbol die GOST-Option „Add default symbol“ gesetzt ist. |
| GOSTNotation | Liest oder setzt, ob beim Oberflächensymbol die GOST-Option „Use for notation“ gesetzt ist. |
| Grinding | veraltet ersetzt durch SFSymbol.GetSymbolSurfaceTexture |
| Orientation | Liest oder setzt die Ausrichtung des Oberflächensymbols: waagrecht, senkrecht, im Winkel des Elements, gespiegelt oder in einem eigenen Winkel. |
| ProfileAngle | Liest oder setzt den Winkel der Profilrichtung des Oberflächensymbols. |
| ProfileDirection | Liest oder setzt die Profilrichtung des Oberflächensymbols: keine, senkrecht, parallel, kreisförmig oder unter einem Winkel. |
| Rotated | veraltet ersetzt durch SFSymbol.Orientation |
Methoden 35, davon 33 beschrieben, 2 veraltet
| Name | Beschreibung |
|---|---|
| GetAngle | Liefert den Winkel des Oberflächensymbols. |
| GetAnnotation | Liefert die Beschriftung (Annotation), zu der das Oberflächensymbol gehört. |
| GetArcAtIndex | Liefert Linientyp, Anfangs-, End- und Mittelpunkt und Drehsinn eines Bogens in der Darstellung des Oberflächensymbols. |
| GetArcCount | Liefert die Zahl der Bögen in der Darstellung des Oberflächensymbols. |
| GetArrowHeadAtIndex | Liefert Spitze, Richtung, Maße und Art einer Pfeilspitze in der Darstellung des Oberflächensymbols. |
| GetArrowHeadCount | Liefert die Zahl der Pfeilspitzen in der Darstellung des Oberflächensymbols. |
| GetArrowHeadInfo | Liefert Länge, Maße und Art der Pfeilspitze am fernen Ende der Bezugslinie. |
| GetDirectionOfLay | Liefert die Rillenrichtung des Oberflächensymbols. |
| GetLeaderAtIndex | Liefert die Punkte einer Bezugslinie des Oberflächensymbols. |
| GetLeaderCount | Liefert die Zahl der Bezugslinien am Oberflächensymbol. |
| GetLineAtIndex | Liefert Linientyp, Anfangs- und Endpunkt einer Linie in der Darstellung des Oberflächensymbols. |
| GetLineCount | Liefert die Zahl der Linien in der Darstellung des Oberflächensymbols. |
| GetNext | Liefert das nächste Oberflächensymbol in der Zeichenansicht. |
| GetSymbol | Liefert die Art des Oberflächensymbols, etwa Grundsymbol oder Materialabtrag gefordert. |
| GetSymbolAllAround | Liefert, ob das Oberflächensymbol für ringsum oder nur örtlich gilt. |
| GetSymbolSurfaceTexture | Liefert die Oberflächenstufe nach JIS eines Oberflächensymbols. |
| GetSymbolType | veraltet ersetzt durch SFSymbol.GetSymbol |
| GetText | Liefert ein Textfeld des Oberflächensymbols, etwa einen Rauheitswert oder das Fertigungsverfahren. |
| GetTextAngleAtIndex | Liefert den Winkel eines Textstücks in der Darstellung des Oberflächensymbols. |
| GetTextAtIndex | Liefert ein Textstück aus der Darstellung des Oberflächensymbols. |
| GetTextCount | Liefert die Zahl der Textstücke in der Darstellung des Oberflächensymbols. |
| GetTextFontAtIndex | Liefert die Schriftart eines Textstücks in der Darstellung des Oberflächensymbols. |
| GetTextHeightAtIndex | Liefert die Schrifthöhe eines Textstücks in der Darstellung des Oberflächensymbols. |
| GetTextInvertAtIndex | Liefert, ob ein Textstück in der Darstellung des Oberflächensymbols an der X-Achse gespiegelt ist. |
| GetTextPositionAtIndex | Liefert die Lage eines Textstücks relativ zum Ursprung des Oberflächensymbols. |
| GetTextRefPositionAtIndex | Liefert, auf welchen Punkt eines Textstücks sich seine Lage bezieht, etwa oben links oder Mitte. |
| GetTriangleAtIndex | Liefert die Eckpunkte, die Füllung und den Linientyp eines Dreiecks in der Darstellung des Oberflächensymbols. |
| GetTriangleCount | Liefert die Zahl der Dreiecke in der Darstellung des Oberflächensymbols. |
| HasExtraLeader | Liefert, ob die Bezugslinie des Oberflächensymbols geknickt ist, also eine zusätzliche Linie hat. |
| IsAttached | Liefert, ob das Oberflächensymbol mit einer Bezugslinie angehängt ist. |
| SetAngle | Setzt einen eigenen Winkel für das Oberflächensymbol. |
| SetDirectionOfLay | Setzt die Rillenrichtung des Oberflächensymbols. |
| SetSymbol | Setzt die Art des Oberflächensymbols, dazu die Oberflächenstufe nach JIS oder ob es ringsum gilt. |
| SetSymbolType | veraltet ersetzt durch SFSymbol.SetSymbol |
| SetText | Setzt 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.