SolidWorksMakroprogrammierung

Enumeration · SwConst

swFileLoadError_e-Enumeration

Gründe, warum OpenDoc6, OpenDoc7 oder LoadFile4 eine Datei nicht öffnen konnten. Bitmaske, prüfen mit And.

Bibliothek SwConst · 25 Werte · im Code direkt mit Namen verwendbar, zum Beispiel swGenericError

Syntax

Enum swFileLoadError_e
    swGenericError                 = 1
    swFileNotFoundError            = 2
    swInvalidFileTypeError         = 1024
    swFutureVersion                = 8192
    swFileWithSameTitleAlreadyOpen = 65536
    swLiquidMachineDoc             = 131072
    swLowResourcesError            = 262144
    swNoDisplayData                = 524288
    swAddinInteruptError           = 1048576
    swFileRequiresRepairError      = 2097152
    swFileCriticalDataRepairError  = 4194304
    swApplicationBusy              = 8388608
    swConnectedIsOffline           = 16777216
End Enum

Werte

KonstanteWertBedeutung
swGenericError1Ein anderer Fehler, den keiner der übrigen Werte beschreibt.
swFileNotFoundError2Datei nicht gefunden, oder eine referenzierte Datei (Komponente) fehlt. Auch, wenn die referenzierte Datei unterdrückt ist.
swInvalidFileTypeError1024Der Dokumenttyp passt nicht zur Datei, etwa swDocPART für eine Baugruppe. Ermittle den Typ aus der Dateiendung, siehe swDocumentTypes_e.
swFutureVersion8192Die Datei wurde mit einer neueren SOLIDWORKS-Version gespeichert. OpenDoc6 meldet diesen Fehler seit SOLIDWORKS 2012 SP05 nicht mehr, weil sich solche Dateien laden lassen. Ob ein Dokument aus einer neueren Version stammt, prüfst du mit ModelDocExtension.IsFutureVersion.
swFileWithSameTitleAlreadyOpen65536Ein Dokument mit demselben Namen ist schon geöffnet. Schließ es vorher, zum Beispiel mit SldWorks.CloseDoc.
swLiquidMachineDoc131072Die Datei ist mit Liquid Machines verschlüsselt.
swLowResourcesError262144Das Öffnen ist blockiert, weil der Arbeitsspeicher knapp ist oder die Zahl der GDI-Handles das erlaubte Maximum überschritten hat. Schließ andere Dokumente und versuch es erneut.
swNoDisplayData524288Die Datei enthält keine Darstellungsdaten.
swAddinInteruptError1048576Der Benutzer hat das Öffnen unterbrochen, um eine andere Datei zu öffnen. Der Name schreibt sich mit einem r („Interupt“).
swFileRequiresRepairError2097152Die Datei hat nicht kritische Schäden in den Dateieigenschaften. Reparieren lässt sie sich beim Öffnen mit DocumentSpecification.AutoRepair.
swFileCriticalDataRepairError4194304Die Datei hat kritische Datenschäden. Reparieren lässt sie sich beim Öffnen mit DocumentSpecification.CriticalDataRepair.
swApplicationBusy8388608Das Öffnen ist blockiert, weil SOLIDWORKS gerade beschäftigt ist.
swConnectedIsOffline16777216Die Hilfe nennt nur den Namen. Dem Namen nach läuft SOLIDWORKS verbunden mit der 3DEXPERIENCE-Plattform (connected), ist aber gerade offline.
swBasePartNotLoadedWarnveraltet Nicht mehr verwenden, stattdessen swFileLoadWarning_BasePartNotLoaded aus swFileLoadWarning_e.
swDrawingANSIUpdateWarnveraltet Nicht mehr verwenden, stattdessen swFileLoadWarning_DrawingANSIUpdate aus swFileLoadWarning_e.
swDrawingSFSymbolConvertWarnveraltet Nicht mehr verwenden, stattdessen swFileLoadWarning_DrawingSFSymbolConvert aus swFileLoadWarning_e.
swDrawingsOnlyRapidDraftWarnveraltet Nicht mehr verwenden, stattdessen swFileLoadWarning_DrawingsOnlyRapidDraft aus swFileLoadWarning_e.
swFileAlreadyOpenWarnveraltet Nicht mehr verwenden, stattdessen swFileLoadWarning_AlreadyOpen aus swFileLoadWarning_e.
swIdMatchErrorveraltet Nicht mehr verwenden, stattdessen swFileLoadWarning_IdMismatch aus swFileLoadWarning_e.
swNeedsRegenWarnveraltet Nicht mehr verwenden, stattdessen swFileLoadWarning_NeedsRegen aus swFileLoadWarning_e.
swReadOnlyWarnveraltet Nicht mehr verwenden, stattdessen swFileLoadWarning_ReadOnly aus swFileLoadWarning_e.
swSharingViolationWarnveraltet Nicht mehr verwenden, stattdessen swFileLoadWarning_SharingViolation aus swFileLoadWarning_e.
swSheetScaleUpdateWarnveraltet Nicht mehr verwenden, stattdessen swFileLoadWarning_SheetScaleUpdate aus swFileLoadWarning_e.
swViewMissingReferencedConfigveraltet Nicht mehr verwenden, stattdessen swFileLoadWarning_ViewMissingReferencedConfig aus swFileLoadWarning_e.
swViewOnlyRestrictionsveraltet Nicht mehr verwenden, stattdessen swFileLoadWarning_ViewOnlyRestrictions aus swFileLoadWarning_e.

Beispiel

' swApp ist die SOLIDWORKS-Anwendung.
Dim swModel As SldWorks.ModelDoc2
Dim nFehler As Long, nWarnungen As Long
Set swModel = swApp.OpenDoc6("C:\Konstruktion\Anlage.sldasm", swDocASSEMBLY, swOpenDocOptions_Silent, "", nFehler, nWarnungen)
If swModel Is Nothing Then
    If (nFehler And swFileNotFoundError) <> 0 Then Debug.Print "Datei nicht gefunden"
    If (nFehler And swInvalidFileTypeError) <> 0 Then Debug.Print "Dokumenttyp passt nicht zur Datei"
    If (nFehler And swFileWithSameTitleAlreadyOpen) <> 0 Then Debug.Print "Gleichnamiges Dokument schon offen"
ElseIf (nFehler And swFileNotFoundError) <> 0 Then
    Debug.Print "Geöffnet, aber mindestens eine Komponente fehlt"
End If

Bemerkungen

Die Werte sind eine Bitmaske: Mehrere Fehler können zugleich gesetzt sein. SldWorks.OpenDoc6 schreibt sie in den ByRef-Parameter Errors, SldWorks.OpenDoc7 in DocumentSpecification.Error. Auch SldWorks.LoadFile4 und PartDoc.InsertImportedFeature melden Fehler aus dieser Liste. Ob ein Wert darin steckt, prüfst du mit And, wie im Beispiel. 0 heißt: kein Fehler.

Ob das Öffnen gescheitert ist, entscheidet der Rückgabewert Nothing, nicht Errors allein. OpenDoc6 meldet swFileNotFoundError auch dann, wenn eine Baugruppe geöffnet wurde, aber eine Komponentendatei fehlt. Hinweise, die das Öffnen nicht verhindern, stehen getrennt davon im Parameter Warnings mit Werten aus swFileLoadWarning_e. Dort stehen auch die Nachfolger der veralteten Werte dieser Liste.

Beschädigte Dateien repariert SldWorks.OpenDoc7, wenn du DocumentSpecification.AutoRepair bzw. DocumentSpecification.CriticalDataRepair auf True setzt. Das gilt nur zusammen mit DocumentSpecification.Silent = True. Ohne Reparatur scheitert das Öffnen mit einem Fehler, den die Hilfe „FileRequiresAutoRepair“ bzw. „FileRequiresCriticalDataRepair“ nennt. Dem Namen nach sind damit swFileRequiresRepairError und swFileCriticalDataRepairError gemeint.

Verwendet von

Siehe auch

Englisches Original: swFileLoadError_e in der SOLIDWORKS API-Hilfe ↗

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