SolidWorksMakroprogrammierung

Objekt · SldWorks

AdvancedSaveAsOptions-Objekt

Erweiterte Optionen für „Speichern unter“: Referenzen umbenennen und verschieben, als Kopie speichern, Konfigurationen wählen, Baugruppe als Teil, ältere Version.

Deklaration Dim x As SldWorks.AdvancedSaveAsOptions · in der englischen .NET-Hilfe: IAdvancedSaveAsOptions

Beschreibung

Das Objekt gibt Zugriff auf alle Optionen von Datei › Speichern unter für Teile, Baugruppen und Zeichnungen. Du holst es mit ModelDocExtension.GetAdvancedSaveAsOptions, setzt die Optionen und übergibst es an ModelDocExtension.SaveAs3 (Parameter AdvancedSaveAsOptions).

Zugriff

Beispiel

' Speichert die aktive Baugruppe samt Teilen als Kopie in den Unterordner "Kopie". Die Teile bekommen "_K" an den Namen.
' Vorbedingung: Eine gespeicherte Baugruppe ist geöffnet.
' Ergebnis:     Neben der Baugruppe liegt der Ordner "Kopie" mit Baugruppe und Teilen. Offen bleibt die alte Baugruppe.
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swAdvOpt As SldWorks.AdvancedSaveAsOptions
    Dim vIDs As Variant, vNamen As Variant, vPfade As Variant
    Dim sOrdner As String
    Dim i As Long, nPunkt As Long, nErg As Long, nFehler As Long, nWarnungen As Long

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Then Exit Sub
    If swModel.GetType <> swDocASSEMBLY Or swModel.GetPathName = "" Then Exit Sub

    sOrdner = Left(swModel.GetPathName, InStrRev(swModel.GetPathName, "\")) & "Kopie"
    If Dir(sOrdner, vbDirectory) = "" Then MkDir sOrdner

    Set swAdvOpt = swModel.Extension.GetAdvancedSaveAsOptions(swSaveWithReferencesOptions_None)
    swAdvOpt.SaveAllAsCopy = True              ' die offene Baugruppe bleibt die alte
    swAdvOpt.GetItemsNameAndPath vIDs, vNamen, vPfade
    For i = 0 To UBound(vIDs)
        vPfade(i) = sOrdner                    ' Eintrag 0 ist die Baugruppe selbst, auch sie kommt nach "Kopie"
        If i > 0 Then                          ' "_K" vor die Endung: aus Quader.SLDPRT wird Quader_K.SLDPRT
            nPunkt = InStrRev(vNamen(i), ".")
            vNamen(i) = Left(vNamen(i), nPunkt - 1) & "_K" & Mid(vNamen(i), nPunkt)
        End If
    Next i
    nErg = swAdvOpt.ModifyItemsNameAndPath(vIDs, vNamen, vPfade)
    If nErg <> swSaveItemsPathError_Succeeded Then
        Debug.Print "Namen und Pfade nicht übernommen, Fehler " & nErg
        Exit Sub
    End If

    ' Das Ziel der Baugruppe kommt aus Eintrag 0 der Liste (siehe Bemerkungen), hier steht derselbe Name.
    If swModel.Extension.SaveAs3(sOrdner & "\" & vNamen(0), swSaveAsCurrentVersion, swSaveAsOptions_Silent + swSaveAsOptions_Copy, _
                                 Nothing, swAdvOpt, nFehler, nWarnungen) Then
        Debug.Print "Gespeichert in " & sOrdner
    Else
        Debug.Print "Nicht gespeichert, Fehler " & nFehler & ", Warnungen " & nWarnungen
    End If
End Sub

Bemerkungen

Ablauf: Das Beispiel folgt dem Hilfebeispiel auf der Objektseite. Es holt die Optionen, setzt SaveAllAsCopy und holt die Liste. Dann ändert es Pfade und Namen, übernimmt sie mit ModifyItemsNameAndPath und speichert mit ModelDocExtension.SaveAs3 und swSaveAsOptions_Silent + swSaveAsOptions_Copy. Das Hilfebeispiel speichert eine Zeichnung, die Referenzen legt es in einen eigenen Ordner. Den Suffix hängt das Beispiel selbst an, statt AdvancedSaveAsOptions.SetPrefixSuffixToAll zu nehmen. Die Methode setzt in SOLIDWORKS 2024 zusätzlich den Ordnernamen vor die Namen (siehe dort). Die Kopie der Baugruppe verweist auf die kopierten Teile, das Original bleibt unverändert.

Ziel des obersten Dokuments: Mit diesen Optionen nimmt SaveAs3 Namen und Ordner des obersten Dokuments aus Eintrag 0 der Liste, nicht aus dem Parameter Name. Änderst du Eintrag 0 nicht, speichert SaveAs3 über die offene Datei und meldet trotzdem Erfolg. Die Datei unter Name entsteht dann nicht. Setze Eintrag 0 darum immer mit AdvancedSaveAsOptions.ModifyItemsNameAndPath. Speicherst du in ein anderes Format, etwa eine Baugruppe als Teil, gilt dagegen Name.

Offenes Dokument: swSaveAsOptions_Copy allein hält die alte Datei nicht offen. Ohne AdvancedSaveAsOptions.SaveAllAsCopy = True ist danach die neue Datei das offene Dokument, mit True bleibt es die alte.

Nur schreibbar: Alle Eigenschaften lassen sich nur setzen, nicht lesen. Die VBA-Syntax der Hilfe nennt bei ihnen keinen Typ. Die Seiten hier nehmen ihn aus der .NET-Syntax der Hilfe.

Ältere Version: Für AdvancedSaveAsOptions.SaveAsPreviousVersion musst du Namen oder Pfad aller Referenzen ändern, sonst kann das Speichern scheitern.

Eigenschaften und Methoden

Eigenschaften 7, davon 7 beschrieben

NameBeschreibung
ConfigurationsToSaveSetzt die Konfigurationen, die beim Speichern unter mitgespeichert werden. Die aktive Konfiguration kommt immer mit.
DescriptionSetzt eine Beschreibung für das Speichern unter.
GeometryToSaveSetzt, welche Geometrie gespeichert wird, wenn du eine Baugruppe als Teil speicherst.
OverrideDefaultsSetzt, ob beim Speichern einer Baugruppe als Teil die Vorgaben überschrieben werden.
PreserveGeometryReferencesSetzt, ob beim Speichern einer Baugruppe als Teil die Geometriereferenzen erhalten bleiben.
SaveAllAsCopySetzt, ob beim Speichern unter alle referenzierten Komponenten als Kopie gespeichert werden.
SaveAsPreviousVersionSetzt die ältere SOLIDWORKS-Version, in der beim Speichern unter gespeichert wird.

Methoden 3, davon 3 beschrieben

NameBeschreibung
GetItemsNameAndPathLiefert IDs, Namen und Pfade aller Referenzen, die beim Speichern unter mitgespeichert werden.
ModifyItemsNameAndPathÄndert Namen und Pfade der Referenzen, unter denen sie beim Speichern unter gespeichert werden.
SetPrefixSuffixToAllSetzt einen Text vor (Präfix) und hinter (Suffix) die Namen aller Referenzen beim Speichern unter, außer beim obersten Dokument.

Siehe auch

Englisches Original: IAdvancedSaveAsOptions in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)

Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.