Methode · AdvancedSaveAsOptions
ModifyItemsNameAndPath-Methode (AdvancedSaveAsOptions)
Ändert Namen und Pfade der Referenzen, unter denen sie beim Speichern unter gespeichert werden.
Syntax
Function ModifyItemsNameAndPath( _
ByVal IdsList As Variant, _
ByVal NamesList As Variant, _
ByVal PathsList As Variant _
) As LongnErg = swAdvOpt.ModifyItemsNameAndPath(vIDs, vNamen, vPfade)Parameter
IdsListVariantByVal- Array mit den IDs der Referenzen, wie es
AdvancedSaveAsOptions.GetItemsNameAndPathliefert. NamesListVariantByVal- Array mit den neuen Namen.
PathsListVariantByVal- Array mit den neuen Pfaden.
Rückgabewert
Ein Wert aus swSaveItemsPathError_e, bei Erfolg swSaveItemsPathError_Succeeded.
Beispiel
' swAdvOpt sind die erweiterten Optionen (AdvancedSaveAsOptions), etwa aus ModelDocExtension.GetAdvancedSaveAsOptions.
' Der Ordner C:\Temp\Ref existiert.
Dim vIDs As Variant, vNamen As Variant, vPfade As Variant
Dim i As Long, nErg As Long
swAdvOpt.GetItemsNameAndPath vIDs, vNamen, vPfade
For i = 0 To UBound(vIDs)
vPfade(i) = "C:\Temp\Ref" ' Eintrag 0 ist das oberste Dokument, auch es kommt in den Ordner
Next i
nErg = swAdvOpt.ModifyItemsNameAndPath(vIDs, vNamen, vPfade)
If nErg <> swSaveItemsPathError_Succeeded Then Debug.Print "Nicht übernommen, Fehler " & nErgBemerkungen
Du rufst vorher AdvancedSaveAsOptions.SetPrefixSuffixToAll und AdvancedSaveAsOptions.GetItemsNameAndPath auf, letzteres, um die Liste der IDs zu bekommen. SetPrefixSuffixToAll ist allerdings nicht nötig. Ohne sie gelten die Namen genau so, wie du sie übergibst.
Die drei Arrays müssen gleich groß sein, ihre Einträge gehören der Reihe nach zusammen. Für eine Referenz, die bleiben soll, nimmst du Nothing. Das Hilfebeispiel lässt solche Einträge einfach so, wie GetItemsNameAndPath sie geliefert hat.
Eintrag 0 ist das oberste Dokument. Änderst du seinen Namen oder Pfad, gilt das statt des Namens, den du an ModelDocExtension.SaveAs3 übergibst. Eintrag 0 gilt auch unverändert. SaveAs3 speichert das oberste Dokument dann an seinem alten Ort, also über die offene Datei. Das Beispiel oben ändert darum auch Eintrag 0.
Siehe auch
Verfügbarkeit
SOLIDWORKS 2020 SP02
Englisches Original: IAdvancedSaveAsOptions::ModifyItemsNameAndPath in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.