_Word_DocOpen
Öffnet ein Word Dokument
#include <Word.au3>
_Word_DocOpen ( $oAppl, $sFilePath [, $bConfirmConversions = False [, $iFormat = $WdOpenFormatAuto [, $bReadOnly = False [, $bRevert = False [, $bAddToRecentFiles = False [, $sOpenPassword = "" [, $sWritePassword = ""]]]]]]] )
Parameter
| $oAppl | Word Objekt wie es von einem vorherigen Aufruf von _Word_Create() zurückgegeben wurde |
| $sFilePath | Der Name oder volle Pfad des Dokumentes das geöffnet werden soll |
| $bConfirmConversions | [optional] Bei True wird der Datei-Konvertierungs Dialog angezeigt when die Datei kein Word Dokument ist (Standard = False) |
| $iFormat | [optional] Definiert das Format, das verwendet werden soll, wenn das Dokument geöffnet wird. Kann eine Konstante der WdOpenFormat Aufzählung sein (Standard = $WdOpenFormatAuto = das bestehende Format) |
| $bReadOnly | [optional] Bei True wird das Dokument im Lesemodus geöffnet (Standard = False) Es ist folgendes zu beachten: Dieses Argument überschreibt nicht die empfohlene Einstellung Schreibschutz bei einem gespeicherten Dokument. |
| $bRevert | [optional] Definiert, was passiert, wenn $sFilePath der name eines bereits geöffneten Dokumentes ist. True verwirft alle ungesicherten Änderungen des offenen Dokumentes und öffnet die Datei nochmals. False aktiviert das geöffnete Dokument (Standard = False) |
| $bAddToRecentFiles | [optional] Bei True wird der Dateiname zur Liste der zuletzt benutzten Dateien (MRU) hinzugefügt (Standard = False) |
| $sOpenPassword | [optional] Das Passwort um das Dokument zu öffnen |
| $sWritePassword | [optional] Das Passwort um Änderungen am Dokument zu speichern |
Rückgabewert
| Erfolg: | Das Objekt des geöffneten Dokumentes. @extended wird auf 1 gesetzt, wenn $bReadOnly = False aber kein Schreibzugriff möglich ist. Details dazu im Abschnitt "Anmerkungen" (Remarks). |
| Fehler: | Setzt das @error Flag auf ungleich null. |
| @error: | 1 - $oAppl ist kein Objekt 2 - Die angegebene Datei existiert nicht 3 - Ein Fehler trat beim Öffnen der angegebenen Datei auf. @extended wird auf den COM Fehlercode gesetzt |
Bemerkungen
Wenn $bReadOnly = False aber das angegebene Dokument nicht mit Schreibzugriff geöffnet werden konnte, dann wird @extended = 1 gesetzt.
Dies geschieht, wenn das Dokument bereits von einem anderen Benutzer/Task geöffnet wurde oder der Schreibzugriff durch das Dateisystem verhindert wird.
Wird das Dokument trotzdem geändert, so müssen die Änderungen mittels _Word_DocSaveAs() mit einem andren Namen oder an einn anderen Ort gesichert werden.
Verwandte Funktionen
_Word_DocClose, _Word_DocSave, _Word_DocSaveAs
Beispiel
#include <MsgBoxConstants.au3>
#include <Word.au3>
; Erzeugt ein neues oder stellt eine Verbindung zu einem bestehenden Word-Objekt her
Local $oWord = _Word_Create()
If @error Then Exit MsgBox($MB_SYSTEMMODAL, "Word UDF: _Word_DocOpen Beispiel", _
"Fehler beim Erstellen des Word-Anwendungsobjektes." & @CRLF & "@error = " & @error & ", @extended = " & @extended)
; Öffnet das Testdokument im Lesemodus
Local $sDocument = @ScriptDir & "\Extras\Test.doc"
_Word_DocOpen($oWord, $sDocument, Default, Default, True)
If @error Then Exit MsgBox($MB_SYSTEMMODAL, "Word UDF: _Word_DocOpen Beispiel", "Fehler beim Öffnen von '.\Extras\Test.doc'." & _
@CRLF & "@error = " & @error & ", @extended = " & @extended)
MsgBox($MB_SYSTEMMODAL, "Word UDF: _Word_DocOpen Beispiel", "Dokument '" & $sDocument & "' wurde erfolgreich geöffnet.")