Objekt · SldWorks
PackAndGo-Objekt
Pack and Go eines Dokuments: Es sammelt alle Dokumente, aus denen das Modell besteht, und kopiert sie, auf Wunsch umbenannt, in einen Ordner oder eine Zip-Datei.
Beschreibung
PackAndGo gibt Zugriff auf Pack and Go. Pack and Go sammelt alle Dokumente, aus denen ein Modell besteht, auf Wunsch mit Zeichnungen, Simulationsergebnissen, Toolbox-Teilen und weiteren Dateien. Es kopiert sie in einen Ordner oder in eine Zip-Datei, auf Wunsch unter neuen Namen. Du richtest PackAndGo ein und führst es dann mit ModelDocExtension.SavePackAndGo aus. Die meisten Befehle gibt es seit SOLIDWORKS 2011, PackAndGo.FolderStructureOption und PackAndGo.SetSaveToName2 erst seit SOLIDWORKS 2025 SP01.
Zugriff
ModelDocExtension.GetPackAndGo: das PackAndGo eines offenen Dokuments. Ausgeführt wird es mitModelDocExtension.SavePackAndGo.
Beispiel
' Packt das aktive Dokument mit allen Dokumenten und Zeichnungen in den Ordner
' C:\Temp\PackAndGo, alle Dateien in einen Ordner und mit dem Präfix "Kopie_".
' Vorbedingung: Ein gespeichertes Teil oder eine gespeicherte Baugruppe ist offen,
' den Ordner C:\Temp\PackAndGo gibt es. Ab SOLIDWORKS 2025 SP01.
' Ergebnis: Die Dateien liegen im Ordner, Quelle und Ziel jeder Datei stehen im
' Direktfenster.
Option Explicit
Sub main()
Dim swApp As SldWorks.SldWorks
Dim swModel As SldWorks.ModelDoc2
Dim swPackAndGo As SldWorks.PackAndGo
Dim vQuellen As Variant, vZiele As Variant, vArten As Variant
Dim vStatus As Variant
Dim i As Long
Set swApp = Application.SldWorks
Set swModel = swApp.ActiveDoc
If swModel Is Nothing Then Exit Sub
If swModel.GetPathName = "" Then Exit Sub ' noch nie gespeichert
Set swPackAndGo = swModel.Extension.GetPackAndGo
swPackAndGo.IncludeDrawings = True
swPackAndGo.FolderStructureOption = swPackAndGoFolderOptions_SingleFolder
swPackAndGo.AddPrefix = "Kopie_"
If False = swPackAndGo.SetSaveToName2(True, "C:\Temp\PackAndGo\") Then Exit Sub
If swPackAndGo.GetDocumentNames(vQuellen) Then
If swPackAndGo.GetDocumentSaveToNames(vZiele, vArten) Then
For i = 0 To UBound(vQuellen)
Debug.Print vQuellen(i) & " -> " & vZiele(i)
Next i
End If
End If
vStatus = swModel.Extension.SavePackAndGo(swPackAndGo)
If IsArray(vStatus) Then
For i = 0 To UBound(vStatus)
If vStatus(i) <> swPackAndGoSaveStatus_Succeed Then Debug.Print "Datei " & i & ": Status " & vStatus(i) ' swPackAndGoSaveStatus_e
Next i
End If
End SubBemerkungen
Ablauf: Richte Pack and Go erst ein und rufe dann ModelDocExtension.SavePackAndGo auf. Der Aufruf führt Pack and Go aus und beendet die Sitzung. Ein zweiter Aufruf schlägt fehl, solange du die Einstellungen nicht neu setzt.
Zielnamen: Die Ziele legst du je Dokument mit PackAndGo.SetDocumentSaveToNames fest oder für alle mit PackAndGo.SetSaveToName2. SetSaveToName2 überschreibt die einzelnen Pfade und Namen. Präfix und Suffix (PackAndGo.AddPrefix, PackAndGo.AddSuffix) gelten für alle Dateinamen. PackAndGo.GetDocumentSaveToNames liefert die Namen samt Präfix und Suffix.
Ordnerstruktur: Seit SOLIDWORKS 2025 SP01 legt PackAndGo.FolderStructureOption fest, ob alle Dateien in einen Ordner kommen, in möglichst wenige Ordner oder in die ganze Ordnerstruktur (swPackAndGoFolderOptions_e). Ältere Makros nutzen PackAndGo.FlattenToSingleFolder, das es seit SOLIDWORKS 2015 gibt.
Zielordner: Die Hilfebeispiele geben den Zielordner mit abschließendem \ an und setzen voraus, dass es ihn gibt. Ob SOLIDWORKS fehlende Ordner anlegt, sagt die Hilfe nicht.
Hilfebeispiele: „Pack and Go an Assembly“ gibt Quell- und Zielnamen einer Baugruppe aus, nimmt Zeichnungen, Simulationsergebnisse und Toolbox-Teile mit, setzt Präfix und Suffix und packt alles in einen Ordner. „Add and Remove Files from Pack and Go“ nimmt die Render-Dateien aus ModelDocExtension.GetRenderStockReferences und weitere Dateien mit und entfernt eine davon wieder. „Pack and Go Part and Linked Equation“ packt ein Teil, dessen Gleichungen in einer verknüpften Datei stehen. Die Gleichungsdatei kommt dabei mit, ohne dass das Makro sie eigens hinzufügt.
Eigenschaften und Methoden
Eigenschaften 8, davon 8 beschrieben
| Name | Beschreibung |
|---|---|
| AddPrefix | Liest oder setzt ein Präfix, das Pack and Go vor alle Dateinamen setzt. |
| AddSuffix | Liest oder setzt ein Suffix, das Pack and Go an alle Dateinamen anhängt. |
| FlattenToSingleFolder | Liest oder setzt, ob Pack and Go alle Dateien direkt in den Zielordner speichert, statt die Ordnerstruktur des Modells nachzubilden. |
| FolderStructureOption | Liest oder setzt, in welcher Ordnerstruktur Pack and Go die Dateien speichert: ein Ordner, möglichst wenige Ordner oder die ganze Struktur. |
| IncludeDrawings | Liest oder setzt, ob Pack and Go die Zeichnungen des Modells mitnimmt. |
| IncludeSimulationResults | Liest oder setzt, ob Pack and Go die Ergebnisse von SOLIDWORKS Simulation mitnimmt. |
| IncludeSuppressed | Liest oder setzt, ob Pack and Go unterdrückte Komponenten mitnimmt. |
| IncludeToolboxComponents | Liest oder setzt, ob Pack and Go die Komponenten aus SOLIDWORKS Toolbox mitnimmt. |
Methoden 10, davon 9 beschrieben, 1 veraltet
| Name | Beschreibung |
|---|---|
| AddExternalDocuments | Nimmt Dateien, die nicht von SOLIDWORKS sind, mit in Pack and Go auf, etwa Render-Dateien oder Dokumente aus anderen Programmen. |
| GetDocumentNames | Liefert die ursprünglichen Pfade und Namen aller Dokumente des Modells für Pack and Go. |
| GetDocumentNamesCount | Liefert die Zahl der Dokumente, aus denen das Modell für Pack and Go besteht. |
| GetDocumentSaveToNames | Liefert Zielpfad und Namen jedes Dokuments und die Art der Dokumente, etwa ob sie virtuell sind. |
| GetExternalDocuments | Liefert Pfad und Namen der Dateien, die nicht von SOLIDWORKS sind und in Pack and Go aufgenommen wurden. |
| GetSaveToName | Liefert den gemeinsamen Zielordner oder die Zip-Datei, die für Pack and Go gesetzt ist. |
| RemoveExternalDocuments | Entfernt Dateien, die nicht von SOLIDWORKS sind, wieder aus Pack and Go. |
| SetDocumentSaveToNames | Setzt Zielpfad und Namen für jedes Dokument des Modells, ein leerer Name nimmt das Dokument heraus. |
| SetSaveToName | veraltet ersetzt durch PackAndGo.SetSaveToName2 |
| SetSaveToName2 | Legt einen gemeinsamen Zielordner oder eine Zip-Datei für alle Dokumente fest und überschreibt damit die einzelnen Zielpfade und Namen. |
Nicht aufgeführt sind 3 C++-Varianten (Namen mit I davor, zum Beispiel IGetDocumentNames). In VBA nimmst du immer den Befehl ohne I.
Siehe auch
Englisches Original: IPackAndGo in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.