SolidWorksMakroprogrammierung

Enumeration · SwConst

swRenameDocumentError_e-Enumeration

Ergebnis von ModelDocExtension.RenameDocument: ob die ausgewählte Komponente umbenannt wurde oder warum nicht.

Bibliothek SwConst · 20 Werte · im Code direkt mit Namen verwendbar, zum Beispiel swRenameDocumentError_None

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 Enum

Werte

KonstanteWertBedeutung
swRenameDocumentError_None0Erfolg. Die Komponente trägt den neuen Namen im Speicher.
swRenameDocumentError_UnspecifiedInternalError1Interner Fehler, Umbenennen nicht möglich.
swRenameDocumentError_InvalidSelection2Die Auswahl ist keine Komponente, die sich umbenennen lässt. Wähl eine gültige Komponente aus.
swRenameDocumentError_InvalidForDrawings3Zeichnungen lassen sich so nicht umbenennen.
swRenameDocumentError_NoModelLoaded4Das Modell der Komponente ist nicht geladen.
swRenameDocumentError_ComponentNotResolved5Die Komponente ist nicht aufgelöst. Lös sie vorher auf.
swRenameDocumentError_LightWeightComponent6Die übergeordnete Komponente ist reduziert. Untergeordnete Komponenten lassen sich dann nicht umbenennen.
swRenameDocumentError_RoutingComponent7Routing-Komponenten lassen sich nicht umbenennen.
swRenameDocumentError_FileAlreadyExists8Eine Datei mit dem neuen Namen gibt es schon auf der Festplatte.
swRenameDocumentError_InvalidCharactersInName9Der Name ist zu lang oder enthält ungültige Zeichen.
swRenameDocumentError_InvalidVirtualComponent10Virtuelle Komponenten lassen sich nicht umbenennen.
swRenameDocumentError_NameTooLong11Der neue Name ist zu lang.
swRenameDocumentError_DocumentNameInUse12Ein geöffnetes Dokument hat schon diesen Namen.
swRenameDocumentError_PendingNameAlreadyInUse13Ein anderes Dokument wurde schon vorläufig auf diesen Namen umbenannt, aber noch nicht gespeichert.
swRenameDocumentError_ReadOnlyDocument14Das Dokument ist schreibgeschützt oder wird von einem schreibgeschützten Dokument referenziert.
swRenameDocumentError_DocumentNotSaved15Umbenennen nicht möglich, das Dokument wurde nicht gespeichert.
swRenameDocumentError_VirtualComponent16Virtuelle Komponenten lassen sich nicht umbenennen.
swRenameDocumentError_NotAllowedWithPDM17Nicht möglich, weil das Add-in SOLIDWORKS Professional PDM nicht geladen ist.
swRenameDocumentError_ToolboxComponent18Toolbox-Komponenten lassen sich nicht umbenennen.
swRenameDocumentError_PatternedComponent19Komponenten 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 Select

Bemerkungen

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.