SolidWorksMakroprogrammierung

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 Boolean
bErfolg = swModel.Save3(Options, Errors, Warnings)

Parameter

OptionsLongByVal

Wie gespeichert wird: ein oder mehrere Werte aus swSaveAsOptions_e, mehrere mit + verbunden. 0 heißt Standardverhalten mit Rückfragen. Für Save3 sinnvoll:

  • swSaveAsOptions_Silent (1): ohne Rückfragen
  • swSaveAsOptions_SaveReferenced (4): auch alle Teile und Unterbaugruppen speichern
  • swSaveAsOptions_AvoidRebuildOnSave (8): vor dem Speichern nicht neu aufbauen
  • swSaveAsOptions_UpdateInactiveViews (16): bei Zeichnungen die Ansichten auf allen Blättern aktualisieren
ErrorsLongByRef · Rückgabe

Hier 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 Fehler
  • swReadOnlySaveError (2): die Datei ist schreibgeschützt
  • swFileLockError (16): die Datei ist von jemand anderem gesperrt
WarningsLongByRef · Rückgabe

Hier 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 Neuaufbau
  • swFileSaveWarning_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 Sub

Bemerkungen

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 If

Ohne 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.