SolidWorksMakroprogrammierung

Methode · DrawingDoc

ModifySurfaceFinishSymbol-Methode (DrawingDoc)

Ändert das ausgewählte Symbol für Oberflächenbeschaffenheit: Art, Bezugslinie, Rillenrichtung und alle Texte.

Syntax

Function ModifySurfaceFinishSymbol( _
   ByVal SymType As Long, _
   ByVal LeaderType As Long, _
   ByVal LocX As Double, _
   ByVal LocY As Double, _
   ByVal LocZ As Double, _
   ByVal LaySymbol As Long, _
   ByVal ArrowType As Long, _
   ByVal MachAllowance As String, _
   ByVal OtherVals As String, _
   ByVal ProdMethod As String, _
   ByVal SampleLen As String, _
   ByVal MaxRoughness As String, _
   ByVal MinRoughness As String, _
   ByVal RoughnessSpacing As String _
) As Boolean
bErfolg = swDraw.ModifySurfaceFinishSymbol(swSFMachining_Req, swNO_LEADER, 0, 0, 0, swSFNone, swCLOSED_ARROWHEAD, "", "", "", "", "Ra 1,6", "", "")

Parameter

SymTypeLongByVal

Die Art des Symbols, ein Wert aus swSFSymType_e, zum Beispiel:

  • swSFBasic (0): Grundsymbol
  • swSFMachining_Req (9): Materialabtrag gefordert
  • swSFDont_Machine (2): Materialabtrag unzulässig

Die übrigen Werte gehören zu den JIS-Symbolen.

LeaderTypeLongByVal
Die Bezugslinie, ein Wert aus swLeaderStyle_e: swNO_LEADER (0) ohne, swSTRAIGHT (1) gerade, swBENT (2) abgewinkelt.
LocXDoubleByVal
X-Position des Symbols. Die Hilfe nennt keine Einheit, vermutlich Meter (siehe Bemerkungen).
LocYDoubleByVal
Y-Position, wie LocX.
LocZDoubleByVal
Z-Position, wie LocX. Auf dem Blatt vermutlich 0.
LaySymbolLongByVal

Die Rillenrichtung, ein Wert aus swSFLaySym_e:

  • swSFNone (0): keine
  • swSFCircular (1): kreisförmig
  • swSFCross (2): gekreuzt
  • swSFMultiDir (3): viele Richtungen
  • swSFParallel (4): parallel
  • swSFPerp (5): senkrecht
  • swSFRadial (6): radial
  • swSFParticulate (7): ungerichtet (Symbol P)
ArrowTypeLongByVal
Die Pfeilspitze der Bezugslinie, ein Wert aus swArrowStyle_e, etwa swCLOSED_ARROWHEAD (1) gefüllt, swOPEN_ARROWHEAD (0) offen, swDOT_ARROWHEAD (3) Punkt oder swNO_ARROWHEAD (10) keine.
MachAllowanceStringByVal
Die Bearbeitungszugabe.
OtherValsStringByVal
Weitere Rauheitswerte.
ProdMethodStringByVal
Das Fertigungsverfahren oder die Behandlung.
SampleLenStringByVal
Die Bezugsstrecke.
MaxRoughnessStringByVal
Die größte zulässige Rauheit.
MinRoughnessStringByVal
Die kleinste zulässige Rauheit.
RoughnessSpacingStringByVal
Der Rillenabstand.

Rückgabewert

Die Hilfe beschreibt den Rückgabewert nicht. Vermutlich True, wenn das Symbol geändert wurde, sonst False.

Beispiel

' swModel ist die aktive Zeichnung (ModelDoc2), swDraw dasselbe Dokument als DrawingDoc (Set swDraw = swModel).
' Vorher ein Symbol für Oberflächenbeschaffenheit auswählen.
Dim swSelMgr As SldWorks.SelectionMgr
Dim bErfolg As Boolean
Set swSelMgr = swModel.SelectionManager
If swSelMgr.GetSelectedObjectCount2(-1) = 0 Then
    Debug.Print "Nichts ausgewählt."
ElseIf swSelMgr.GetSelectedObjectType3(1, -1) <> swSelSFSYMBOLS Then
    Debug.Print "Kein Symbol für Oberflächenbeschaffenheit ausgewählt."
Else
    bErfolg = swDraw.ModifySurfaceFinishSymbol(swSFMachining_Req, swNO_LEADER, 0, 0, 0, swSFPerp, swCLOSED_ARROWHEAD, _
        "0,2", "", "geschliffen", "", "Ra 1,6", "", "")
    Debug.Print "Geändert: " & bErfolg
End If

Bemerkungen

Der Befehl wirkt auf das ausgewählte Symbol für Oberflächenbeschaffenheit. Du übergibst alle Angaben auf einmal. Vermutlich überschreibt ein leerer Text dabei den bisherigen Wert. Willst du nur einen einzelnen Text ändern, ist SFSymbol.SetText mit einem Wert aus swSurfaceFinishSymbolText_e einfacher. Das Objekt SFSymbol bekommst du über die Auswahl, etwa mit SelectionMgr.GetSelectedObject6.

Die Bedeutung von LocX, LocY und LocZ beschreibt die Hilfe hier nicht weiter. Beim Einfügen mit ModelDocExtension.InsertSurfaceFinishSymbol3, der dieselben Parameter hat, nutzt SOLIDWORKS die Position nur, wenn das Symbol eine Bezugslinie hat. Ob das hier genauso gilt, ist nicht dokumentiert.

Neue Symbole erzeugst du mit ModelDocExtension.InsertSurfaceFinishSymbol3. Der alte DrawingDoc.InsertSurfaceFinishSymbol ist veraltet.

Siehe auch

Verfügbarkeit

In allen aktuellen Versionen vorhanden. Seit wann es den Befehl gibt, nennt die Hilfe nicht.

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

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