UDF > Word >


_Word_DocOpen

Ouvre un document Word

#include <Word.au3>
_Word_DocOpen ( $oAppl, $sFilePath [, $bConfirmConversions = False [, $iFormat = $WdOpenFormatAuto [, $bReadOnly = False [, $bRevert = False [, $bAddToRecentFiles = False [, $sOpenPassword = "" [, $sWritePassword = ""]]]]]]] )

Paramètres

$oAppl Objet Word retourné par un appel précédent à _Word_Create()
$sFilePath Le nom ou le chemin d'accès complet du document à ouvrir
$bConfirmConversions [optionnel] True affiche la boîte de dialogue Convertion de fichier si le fichier n'est pas au format Word (par défaut = False)
$iFormat [optionnel] Spécifie le format à utiliser lors de l'ouverture du document.
Peut prendre toute valeur de l'énumération WdOpenFormat (par défaut = $WdOpenFormatAuto = le format existant)
$bReadOnly [optionnel] True pour ouvrir le document en lecture seule (par défaut = False).
Remarque: Cet argument ne remplace pas le paramètre lecture seule recommandé lors de la sauvegarde d'un document.
$bRevert [optionnel] Contrôle ce qui se passe si $sFilePath est le nom d'un document ouvert.
    True annule toutes les modifications non enregistrées dans le document ouvert et re-ouvre le fichier.
    False active le document ouvert (par défaut = False)
$bAddToRecentFiles [optionnel] True ajoute le nom de fichier à la liste des fichiers récemment utilisés au bas du menu Fichier (par défaut = False)
$sOpenPassword [optionnel] Le mot de passe pour ouvrir le document
$sWritePassword [optionnel] Le mot de passe pour enregistrer les modifications au document

Valeur de retour

Succès: Retourne une variable pointant sur l'objet document.
Échec: @error <> 0.
@error: 1 - $oAppl n'est pas un objet
2 - Le document spécifié n'existe pas
3 - Une erreur s'est produite lors de l'ouverture du document spécifié. @extended contient le code d'erreur COM

Remarque

Lorsque vous définissez $bReadOnly = False mais que le document ne peut pas être ouvert en lecture-écriture, @extended est défini à 1.
Le document a été ouvert en lecture seule car il a déjà été ouvert par un autre utilisateur ou une autre tâche ou le fichier est défini en lecture seule par le système de fichiers.
Si vous modifiez le document, vous aurez besoin d'utiliser _Word_DocSaveAs() pour l'enregistrer dans un autre emplacement ou avec un autre nom.

En relation

_Word_DocClose, _Word_DocSave, _Word_DocSaveAs

Exemple

#include <MsgBoxConstants.au3>
#include <Word.au3>

; Crée un objet application
Local $oWord = _Word_Create()
If @error Then Exit MsgBox($MB_SYSTEMMODAL, "Word UDF: _Word_DocOpen Example", _
        "Error creating a new Word application object." & @CRLF & "@error = " & @error & ", @extended = " & @extended)

;
; Ouvre un document en lecture seule
;
Local $sDocument = @ScriptDir & "\Extras\Test.doc"
_Word_DocOpen($oWord, $sDocument, Default, Default, True)
If @error Then Exit MsgBox($MB_SYSTEMMODAL, "Word UDF: _Word_DocOpen Example 1", "Error opening '.\Extras\Test.doc'." & _
        @CRLF & "@error = " & @error & ", @extended = " & @extended)
MsgBox($MB_SYSTEMMODAL, "Word UDF: _Word_DocOpen Example 1", "Document '" & $sDocument & "' has been opened successfully.")