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 BooleanbErfolg = swDraw.ModifySurfaceFinishSymbol(swSFMachining_Req, swNO_LEADER, 0, 0, 0, swSFNone, swCLOSED_ARROWHEAD, "", "", "", "", "Ra 1,6", "", "")Parameter
SymTypeLongByValDie Art des Symbols, ein Wert aus
swSFSymType_e, zum Beispiel:swSFBasic(0): GrundsymbolswSFMachining_Req(9): Materialabtrag gefordertswSFDont_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. LaySymbolLongByValDie Rillenrichtung, ein Wert aus
swSFLaySym_e:swSFNone(0): keineswSFCircular(1): kreisförmigswSFCross(2): gekreuztswSFMultiDir(3): viele RichtungenswSFParallel(4): parallelswSFPerp(5): senkrechtswSFRadial(6): radialswSFParticulate(7): ungerichtet (Symbol P)
ArrowTypeLongByVal- Die Pfeilspitze der Bezugslinie, ein Wert aus
swArrowStyle_e, etwaswCLOSED_ARROWHEAD(1) gefüllt,swOPEN_ARROWHEAD(0) offen,swDOT_ARROWHEAD(3) Punkt oderswNO_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 IfBemerkungen
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.