Methode · ModelDoc2
Save3-Methode (ModelDoc2)
Speichert das Dokument unter seinem bisherigen Namen und in seinem bisherigen Format.
Syntax
Function Save3( _
ByVal Options As Long, _
ByRef Errors As Long, _
ByRef Warnings As Long _
) As BooleanbErfolg = swModel.Save3(Options, Errors, Warnings)Parameter
OptionsLongByValWie gespeichert wird: ein oder mehrere Werte aus
swSaveAsOptions_e, mehrere mit+verbunden.0heißt Standardverhalten mit Rückfragen. Für Save3 sinnvoll:swSaveAsOptions_Silent(1): ohne RückfragenswSaveAsOptions_SaveReferenced(4): auch alle Teile und Unterbaugruppen speichernswSaveAsOptions_AvoidRebuildOnSave(8): vor dem Speichern nicht neu aufbauenswSaveAsOptions_UpdateInactiveViews(16): bei Zeichnungen die Ansichten auf allen Blättern aktualisieren
ErrorsLongByRef · RückgabeHier schreibt SOLIDWORKS hinein, warum das Speichern gescheitert ist, als Summe von Werten aus
swFileSaveError_e. Nach erfolgreichem Speichern ist der Wert 0. Häufig:swGenericSaveError(1): allgemeiner FehlerswReadOnlySaveError(2): die Datei ist schreibgeschütztswFileLockError(16): die Datei ist von jemand anderem gesperrt
WarningsLongByRef · RückgabeHier schreibt SOLIDWORKS Hinweise hinein, auch wenn das Speichern geklappt hat, als Summe von Werten aus
swFileSaveWarning_e. Zum Beispiel:swFileSaveWarning_RebuildError(1): das Modell hat Fehler beim NeuaufbauswFileSaveWarning_NeedsRebuild(2): das Modell muss neu aufgebaut werden
Rückgabewert
True, wenn das Dokument gespeichert wurde, sonst False.
Beispiel
' Speichert das aktive Dokument ohne Rückfragen, aber nur, wenn es geändert wurde.
' Vorbedingung: Ein Teil, eine Baugruppe oder eine Zeichnung ist geöffnet
' und wurde schon einmal gespeichert.
' Ergebnis: Meldung im Direktfenster (Strg+G im VBA-Editor).
Option Explicit
Sub main()
Dim swApp As SldWorks.SldWorks
Dim swModel As SldWorks.ModelDoc2
Dim nFehler As Long
Dim nWarnungen As Long
Set swApp = Application.SldWorks
Set swModel = swApp.ActiveDoc
If swModel Is Nothing Then
swApp.SendMsgToUser2 "Kein Dokument geöffnet.", swMbWarning, swMbOk
Exit Sub
End If
If swModel.GetPathName = "" Then
swApp.SendMsgToUser2 "Noch nie gespeichert.", swMbWarning, swMbOk
Exit Sub
End If
If False = swModel.GetSaveFlag Then
Debug.Print "Keine Änderungen, nichts zu tun."
Exit Sub
End If
If swModel.Save3(swSaveAsOptions_Silent, nFehler, nWarnungen) Then
Debug.Print "Gespeichert: " & swModel.GetPathName
If nWarnungen <> 0 Then Debug.Print "Warnungen: " & nWarnungen
Else
Debug.Print "Nicht gespeichert, Fehler: " & nFehler
End If
End SubBemerkungen
Save3 speichert immer in die Datei, aus der das Dokument geladen wurde. Für einen neuen Dateinamen, ein anderes Format (PDF, STEP, DXF) oder eine Kopie ist ModelDocExtension.SaveAs3 da. Ein neues Dokument, das noch nie gespeichert wurde, hat keinen Pfad (GetPathName liefert einen leeren Text) und kann mit Save3 nicht gespeichert werden.
Errors und Warnings müssen in VBA immer als Long-Variablen übergeben werden, auch wenn du die Werte nicht brauchst. Weil beide Werte Bitmasken sind, prüfst du einen einzelnen Grund mit And:
If (nFehler And swReadOnlySaveError) <> 0 Then
Debug.Print "Die Datei ist schreibgeschützt."
End IfOhne swSaveAsOptions_Silent kann SOLIDWORKS beim Speichern Rückfragen anzeigen, etwa ob geänderte Komponenten einer Baugruppe mitgespeichert werden sollen. Ein Makro, das unbeaufsichtigt läuft, sollte deshalb mit swSaveAsOptions_Silent speichern.
Die älteren Befehle ModelDoc2.Save, ModelDoc2.Save2 und ModelDoc2.SaveSilent sind veraltet und durch Save3 ersetzt.
Siehe auch
In den Videos
Verfügbarkeit
SOLIDWORKS 2001Plus
Englisches Original: IModelDoc2::Save3 in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.