SolidWorksMakroprogrammierung

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 Boolean
bErfolg = swModel.Extension.SaveAs3(Name, Version, Options, ExportData, AdvancedSaveAsOptions, Errors, Warnings)

Parameter

NameStringByVal

Vollständiger Pfad mit Dateinamen. Die Dateiendung bestimmt das Format:

  • .SLDPRT, .SLDASM, .SLDDRW: als SOLIDWORKS-Datei speichern
  • .pdf, .step oder .stp, .igs, .dxf, .dwg und 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 immer swSaveAsCurrentVersion (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. Meist swSaveAsOptions_Silent (ohne Rückfragen), für eine Kopie zusätzlich swSaveAsOptions_Copy.
ExportDataObjectByVal
Beim PDF-Export: ein ExportPdfData-Objekt mit den PDF-Einstellungen, zum Beispiel welche Blätter einer Zeichnung ins PDF kommen. Mit Nothing kommen alle Blätter ins PDF. Bei allen anderen Formaten immer Nothing.
AdvancedSaveAsOptionsObjectByVal
Erweiterte Optionen als AdvancedSaveAsOptions-Objekt, zum Beispiel nur bestimmte Konfigurationen speichern oder referenzierte Komponenten umbenennen und verschieben. Du bekommst es von ModelDocExtension.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 (siehe AdvancedSaveAsOptions).
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 Sub

Bemerkungen

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

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.