Enumeration · SwConst
swRenameDocumentError_e-Enumeration
Ergebnis von ModelDocExtension.RenameDocument: ob die ausgewählte Komponente umbenannt wurde oder warum nicht.
Syntax
Enum swRenameDocumentError_e
swRenameDocumentError_None = 0
swRenameDocumentError_UnspecifiedInternalError = 1
swRenameDocumentError_InvalidSelection = 2
swRenameDocumentError_InvalidForDrawings = 3
swRenameDocumentError_NoModelLoaded = 4
swRenameDocumentError_ComponentNotResolved = 5
swRenameDocumentError_LightWeightComponent = 6
swRenameDocumentError_RoutingComponent = 7
swRenameDocumentError_FileAlreadyExists = 8
swRenameDocumentError_InvalidCharactersInName = 9
swRenameDocumentError_InvalidVirtualComponent = 10
swRenameDocumentError_NameTooLong = 11
swRenameDocumentError_DocumentNameInUse = 12
swRenameDocumentError_PendingNameAlreadyInUse = 13
swRenameDocumentError_ReadOnlyDocument = 14
swRenameDocumentError_DocumentNotSaved = 15
swRenameDocumentError_VirtualComponent = 16
swRenameDocumentError_NotAllowedWithPDM = 17
swRenameDocumentError_ToolboxComponent = 18
swRenameDocumentError_PatternedComponent = 19
End EnumWerte
| Konstante | Wert | Bedeutung |
|---|---|---|
swRenameDocumentError_None | 0 | Erfolg. Die Komponente trägt den neuen Namen im Speicher. |
swRenameDocumentError_UnspecifiedInternalError | 1 | Interner Fehler, Umbenennen nicht möglich. |
swRenameDocumentError_InvalidSelection | 2 | Die Auswahl ist keine Komponente, die sich umbenennen lässt. Wähl eine gültige Komponente aus. |
swRenameDocumentError_InvalidForDrawings | 3 | Zeichnungen lassen sich so nicht umbenennen. |
swRenameDocumentError_NoModelLoaded | 4 | Das Modell der Komponente ist nicht geladen. |
swRenameDocumentError_ComponentNotResolved | 5 | Die Komponente ist nicht aufgelöst. Lös sie vorher auf. |
swRenameDocumentError_LightWeightComponent | 6 | Die übergeordnete Komponente ist reduziert. Untergeordnete Komponenten lassen sich dann nicht umbenennen. |
swRenameDocumentError_RoutingComponent | 7 | Routing-Komponenten lassen sich nicht umbenennen. |
swRenameDocumentError_FileAlreadyExists | 8 | Eine Datei mit dem neuen Namen gibt es schon auf der Festplatte. |
swRenameDocumentError_InvalidCharactersInName | 9 | Der Name ist zu lang oder enthält ungültige Zeichen. |
swRenameDocumentError_InvalidVirtualComponent | 10 | Virtuelle Komponenten lassen sich nicht umbenennen. |
swRenameDocumentError_NameTooLong | 11 | Der neue Name ist zu lang. |
swRenameDocumentError_DocumentNameInUse | 12 | Ein geöffnetes Dokument hat schon diesen Namen. |
swRenameDocumentError_PendingNameAlreadyInUse | 13 | Ein anderes Dokument wurde schon vorläufig auf diesen Namen umbenannt, aber noch nicht gespeichert. |
swRenameDocumentError_ReadOnlyDocument | 14 | Das Dokument ist schreibgeschützt oder wird von einem schreibgeschützten Dokument referenziert. |
swRenameDocumentError_DocumentNotSaved | 15 | Umbenennen nicht möglich, das Dokument wurde nicht gespeichert. |
swRenameDocumentError_VirtualComponent | 16 | Virtuelle Komponenten lassen sich nicht umbenennen. |
swRenameDocumentError_NotAllowedWithPDM | 17 | Nicht möglich, weil das Add-in SOLIDWORKS Professional PDM nicht geladen ist. |
swRenameDocumentError_ToolboxComponent | 18 | Toolbox-Komponenten lassen sich nicht umbenennen. |
swRenameDocumentError_PatternedComponent | 19 | Komponenten in einem Muster lassen sich nicht umbenennen. |
Beispiel
' swModel ist die aktive Baugruppe (ModelDoc2), eine Komponente ist ausgewählt.
Dim nStatus As Long
nStatus = swModel.Extension.RenameDocument("Welle_neu")
Select Case nStatus
Case swRenameDocumentError_None
Debug.Print "Umbenannt, dauerhaft erst nach dem Speichern."
Case swRenameDocumentError_FileAlreadyExists, swRenameDocumentError_DocumentNameInUse
Debug.Print "Name schon vergeben."
Case Else
Debug.Print "Umbenennen fehlgeschlagen, Status " & nStatus
End SelectBemerkungen
ModelDocExtension.RenameDocument benennt die ausgewählte Komponente nur vorläufig um. Bei swRenameDocumentError_None zeigt der FeatureManager den neuen Namen, und alle geöffneten Dokumente, die die Datei referenzieren, verweisen auf den neuen Namen. Dauerhaft wird das erst, wenn du die Baugruppe speicherst.
Verweise in nicht geöffneten Dokumenten aktualisierst du über RenamedDocumentReferences, siehe swRenamedDocumentFinalAction_e. Die Hilfe sagt nicht, worin sich swRenameDocumentError_VirtualComponent und swRenameDocumentError_InvalidVirtualComponent unterscheiden.
Verwendet von
Siehe auch
Englisches Original: swRenameDocumentError_e in der SOLIDWORKS API-Hilfe ↗
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.