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.
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
ModelDocExtension.GetAdvancedSaveAsOptions: die Optionen für das Dokument; welche Referenzen dazugehören, legst du mit einem Wert ausswSaveWithReferencesOptions_efest
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 SubBemerkungen
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
| Name | Beschreibung |
|---|---|
| ConfigurationsToSave | Setzt die Konfigurationen, die beim Speichern unter mitgespeichert werden. Die aktive Konfiguration kommt immer mit. |
| Description | Setzt eine Beschreibung für das Speichern unter. |
| GeometryToSave | Setzt, welche Geometrie gespeichert wird, wenn du eine Baugruppe als Teil speicherst. |
| OverrideDefaults | Setzt, ob beim Speichern einer Baugruppe als Teil die Vorgaben überschrieben werden. |
| PreserveGeometryReferences | Setzt, ob beim Speichern einer Baugruppe als Teil die Geometriereferenzen erhalten bleiben. |
| SaveAllAsCopy | Setzt, ob beim Speichern unter alle referenzierten Komponenten als Kopie gespeichert werden. |
| SaveAsPreviousVersion | Setzt die ältere SOLIDWORKS-Version, in der beim Speichern unter gespeichert wird. |
Methoden 3, davon 3 beschrieben
| Name | Beschreibung |
|---|---|
| GetItemsNameAndPath | Liefert 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. |
| SetPrefixSuffixToAll | Setzt 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.