Methode · ModelDocExtension
SaveAs3-Methode (ModelDocExtension)
Speichert das Dokument unter einem neuen Namen oder exportiert es in ein anderes Format wie PDF, STEP oder DXF.
Syntax
Function SaveAs3( _
ByVal Name As String, _
ByVal Version As Long, _
ByVal Options As Long, _
ByVal ExportData As Object, _
ByVal AdvancedSaveAsOptions As Object, _
ByRef Errors As Long, _
ByRef Warnings As Long _
) As BooleanbErfolg = swModel.Extension.SaveAs3(Name, Version, Options, ExportData, AdvancedSaveAsOptions, Errors, Warnings)Parameter
NameStringByValVollständiger Pfad mit Dateinamen. Die Dateiendung bestimmt das Format:
.SLDPRT,.SLDASM,.SLDDRW: als SOLIDWORKS-Datei speichern.pdf,.stepoder.stp,.igs,.dxf,.dwgund andere: in dieses Format exportieren
Steht nur ein Dateiname ohne Ordner da, landet die Datei im Ordner des aktiven Dokuments.
VersionLongByVal- Wert aus
swSaveAsVersion_e. Fast immerswSaveAsCurrentVersion(0). Andere Werte brauchst du nur, wenn die Endung nicht eindeutig ist, zum Beispiel um eine Zeichnung als abgetrennte Zeichnung zu speichern (swSaveAsDetachedDrawing). OptionsLongByVal- Wie gespeichert wird, Werte aus
swSaveAsOptions_e, mehrere mit+verbunden. MeistswSaveAsOptions_Silent(ohne Rückfragen), für eine Kopie zusätzlichswSaveAsOptions_Copy. ExportDataObjectByVal- Beim PDF-Export: ein
ExportPdfData-Objekt mit den PDF-Einstellungen, zum Beispiel welche Blätter einer Zeichnung ins PDF kommen. MitNothingkommen alle Blätter ins PDF. Bei allen anderen Formaten immerNothing. AdvancedSaveAsOptionsObjectByVal- Erweiterte Optionen als
AdvancedSaveAsOptions-Objekt, zum Beispiel nur bestimmte Konfigurationen speichern oder referenzierte Komponenten umbenennen und verschieben. Du bekommst es vonModelDocExtension.GetAdvancedSaveAsOptions. Für normales Speichern und Exportieren:Nothing. Speicherst du mit dem Objekt im selben Dateityp, nimmt SaveAs3 Namen und Ordner aus dem Objekt, nicht aus Name (sieheAdvancedSaveAsOptions). ErrorsLongByRef · Rückgabe- Hier schreibt SOLIDWORKS hinein, warum das Speichern gescheitert ist, als Summe von Werten aus
swFileSaveError_e. Nach erfolgreichem Speichern 0. WarningsLongByRef · Rückgabe- Hinweise, auch bei Erfolg, als Summe von Werten aus
swFileSaveWarning_e.
Rückgabewert
True, wenn die Datei geschrieben wurde, sonst False.
Beispiel
' Speichert das aktive Teil oder die aktive Baugruppe zusätzlich als STEP-Datei
' in denselben Ordner (Welle.SLDPRT wird zu Welle.STEP).
' Vorbedingung: Ein Teil oder eine Baugruppe ist geöffnet und wurde schon gespeichert.
' Ergebnis: STEP-Datei neben der Originaldatei, Meldung im Direktfenster.
Option Explicit
Sub main()
Dim swApp As SldWorks.SldWorks
Dim swModel As SldWorks.ModelDoc2
Dim sPfad As String
Dim sStep As String
Dim nFehler As Long
Dim nWarnungen As Long
Set swApp = Application.SldWorks
Set swModel = swApp.ActiveDoc
If swModel Is Nothing Then Exit Sub
If swModel.GetType = swDocDRAWING Then
swApp.SendMsgToUser2 "Bitte ein Teil oder eine Baugruppe öffnen.", swMbWarning, swMbOk
Exit Sub
End If
sPfad = swModel.GetPathName
If sPfad = "" Then Exit Sub
sStep = Left(sPfad, InStrRev(sPfad, ".")) & "STEP"
swModel.ClearSelection2 True ' sonst werden nur die ausgewählten Körper exportiert
If swModel.Extension.SaveAs3(sStep, swSaveAsCurrentVersion, swSaveAsOptions_Silent, _
Nothing, Nothing, nFehler, nWarnungen) Then
Debug.Print "Exportiert: " & sStep
Else
Debug.Print "Export fehlgeschlagen, Fehler: " & nFehler
End If
End SubBemerkungen
SaveAs3 oder Save3? ModelDoc2.Save3 speichert in die Datei, aus der das Dokument geladen wurde. SaveAs3 schreibt eine neue Datei: anderer Name, anderer Ordner oder anderes Format. Speicherst du als SOLIDWORKS-Datei unter neuem Namen, arbeitest du danach in der neuen Datei weiter, außer du gibst swSaveAsOptions_Copy mit. Mit einem AdvancedSaveAsOptions-Objekt entscheidet stattdessen dessen Eigenschaft AdvancedSaveAsOptions.SaveAllAsCopy. Beim Export (PDF, STEP, DXF …) bleibt das geöffnete Dokument ohnehin, wie es ist.
Beim Export in STEP, IGES oder STL muss das Dokument das aktive sein. Ein Dokument, das nur im Hintergrund geöffnet ist, holst du vorher mit SldWorks.ActivateDoc3 nach vorn.
Sind Flächen oder Körper ausgewählt, exportiert SaveAs3 nur diese. Für das ganze Modell leerst du die Auswahl vorher mit ModelDoc2.ClearSelection2, wie im Beispiel.
Eine vorhandene Datei mit demselben Namen wird ohne Rückfrage überschrieben, außer sie ist schreibgeschützt. Prüfe vorher mit Dir(sStep) <> "", ob es die Datei schon gibt, wenn das nicht passieren soll.
Weitere Einstellungen für den Export, zum Beispiel wie eine Baugruppe als Teil gespeichert wird, stellst du vorher über die Benutzereinstellungen ein, etwa mit SldWorks.SetUserPreferenceIntegerValue.
Errors und Warnings übergibst du in VBA immer als Long-Variablen, auch wenn du die Werte nicht brauchst.
Vorgänger: ModelDocExtension.SaveAs2 sowie ModelDoc2.SaveAs bis ModelDoc2.SaveAs4 sind veraltet. In älteren Makros findest du oft noch swModel.SaveAs3 direkt auf dem Dokument, das ist ein anderer, veralteter Befehl mit nur drei Parametern.
Siehe auch
In den Videos
- Folge 9Speichern ins PDF-Formatverwendet SaveAs3
- Folge 10Speichern ins DXF/DWG-Formatverwendet SaveAs3
- Folge 11Speichern ins STEP-Format und Bilddateiverwendet SaveAs3
- Folge 12Benutzereingaben mit der InputBoxverwendet SaveAs3
- Folge 16Formular erweitern: STEPverwendet SaveAs3
- Folge 17Formular erweitern: PDFverwendet SaveAs3
- Folge 18Formular erweitern: DXFverwendet SaveAs3
Verfügbarkeit
SOLIDWORKS 2020 SP02
Englisches Original: IModelDocExtension::SaveAs3 in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.