SolidWorksMakroprogrammierung

Enumeration · SwConst

swFileSaveError_e-Enumeration

Gründe, warum Save3, SaveAs3 oder SaveToFile3 eine Datei nicht speichern konnten. Bitmaske, prüfen mit And.

Bibliothek SwConst · 17 Werte · im Code direkt mit Namen verwendbar, zum Beispiel swGenericSaveError

Syntax

Enum swFileSaveError_e
    swGenericSaveError                       = 1
    swReadOnlySaveError                      = 2
    swFileNameEmpty                          = 4
    swFileNameContainsAtSign                 = 8
    swFileLockError                          = 16
    swFileSaveFormatNotAvailable             = 32
    swFileSaveAsDoNotOverwrite               = 128
    swFileSaveAsInvalidFileExtension         = 256
    swFileSaveAsNoSelection                  = 512
    swFileSaveAsBadEDrawingsVersion          = 1024
    swFileSaveAsNameExceedsMaxPathLength     = 2048
    swFileSaveAsNotSupported                 = 4096
    swFileSaveRequiresSavingReferences       = 8192
    swFileSaveAsDetachedDrawingsNotSupported = 16384
    swFileSaveDoNotUpgradeError              = 32768
    swFileSaveIncompatibleItemsError         = 65536
End Enum

Werte

KonstanteWertBedeutung
swGenericSaveError1Allgemeiner Fehler beim Speichern.
swReadOnlySaveError2Die Datei ist schreibgeschützt.
swFileNameEmpty4Der Dateiname ist leer.
swFileNameContainsAtSign8Der Dateiname enthält ein @. Das Zeichen ist in Dateinamen nicht erlaubt.
swFileLockError16Die Datei ist von jemand anderem gesperrt.
swFileSaveFormatNotAvailable32Der Dateityp ist für Speichern unter nicht gültig.
swFileSaveAsDoNotOverwrite128Eine vorhandene Datei nicht überschreiben. Dem Namen nach wurde nicht gespeichert, weil es die Zieldatei schon gibt.
swFileSaveAsInvalidFileExtension256Die Dateiendung passt nicht zum Dokumenttyp, etwa .slddrw für ein Teil.
swFileSaveAsNoSelection512Betrifft das Speichern ausgewählter Körper eines Teils. Der Wert gilt für PartDoc.SaveToFile2, nicht für ModelDocExtension.SaveAs. Dem Namen nach ist dabei nichts ausgewählt.
swFileSaveAsBadEDrawingsVersion1024Die Hilfe nennt nur den Namen. Dem Namen nach passt die eDrawings-Version nicht.
swFileSaveAsNameExceedsMaxPathLength2048Der Dateiname ist zu lang. Es sind höchstens 255 Zeichen erlaubt.
swFileSaveAsNotSupported4096Speichern unter wird nicht unterstützt, oder die neue Datei ist womöglich unvollständig, etwa weil SOLIDWORKS unsichtbar läuft. Dann machst du SOLIDWORKS mit SldWorks.Visible sichtbar und versuchst es erneut. Bleibt der Fehler, verweist die Hilfe auf den API-Support von SOLIDWORKS.
swFileSaveRequiresSavingReferences8192Eine Baugruppe mit umbenannten Komponenten lässt sich nur speichern, wenn die Referenzen mitgespeichert werden. Das erreichst du mit swSaveAsOptions_SaveReferenced aus swSaveAsOptions_e.
swFileSaveAsDetachedDrawingsNotSupported16384Die Optionen fürs Speichern als abgetrennte Zeichnung werden nicht unterstützt.
swFileSaveDoNotUpgradeError32768Der Versuch, eine Datei zu speichern, die zu viele Versionen zurückliegt, während „Do Not Upgrade“ (nicht auf die aktuelle Version hochstufen) eingeschaltet ist.
swFileSaveIncompatibleItemsError65536Das Speichern in eine frühere SOLIDWORKS-Version geht nicht, weil das Dokument Features enthält, die dazu nicht passen.
swFileSaveWithRebuildErrorveraltet Nicht mehr verwenden, stattdessen swFileSaveWarning_RebuildError aus swFileSaveWarning_e.

Beispiel

' swModel ist das aktive Teil (ModelDoc2).
Dim nFehler As Long, nWarnungen As Long
If False = swModel.Extension.SaveAs3("C:\Konstruktion\Welle_neu.sldprt", swSaveAsCurrentVersion, swSaveAsOptions_Silent, _
                                 Nothing, Nothing, nFehler, nWarnungen) Then
    If (nFehler And swReadOnlySaveError) <> 0 Then Debug.Print "Datei ist schreibgeschützt"
    If (nFehler And swFileLockError) <> 0 Then Debug.Print "Datei ist gesperrt"
    If (nFehler And swFileSaveAsInvalidFileExtension) <> 0 Then Debug.Print "Endung passt nicht zum Dokumenttyp"
    If (nFehler And swFileSaveAsNameExceedsMaxPathLength) <> 0 Then Debug.Print "Dateiname zu lang"
End If

Bemerkungen

Die Werte sind eine Bitmaske: Mehrere Fehler können zugleich gesetzt sein. ModelDoc2.Save3, ModelDocExtension.SaveAs3 und PartDoc.SaveToFile3 schreiben sie in den ByRef-Parameter Errors, SldWorks.CheckpointConvertedDocument liefert sie als Rückgabewert. Ob ein Wert darin steckt, prüfst du mit And, wie im Beispiel. 0 heißt: kein Fehler.

Ob das Speichern geklappt hat, sagt der Rückgabewert True oder False. Nicht jeder Wert ist ein echter Fehler: Manche Bedingungen sind nur Hinweise oder Warnungen. Hinweise, die das Speichern nicht verhindern, stehen getrennt davon im Parameter Warnings mit Werten aus swFileSaveWarning_e. Errors und Warnings übergibst du in VBA immer als Long-Variablen.

Dieselben Werte melden auch die veralteten Vorgänger ModelDocExtension.SaveAs, ModelDocExtension.SaveAs2 und PartDoc.SaveToFile2.

Verwendet von

Siehe auch

Englisches Original: swFileSaveError_e in der SOLIDWORKS API-Hilfe ↗

Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.