UDF > Excel >


_Excel_BookOpen

Ouvre un classeur existant

#include <Excel.au3>
_Excel_BookOpen ( $oExcel, $sFilePath [, $bReadOnly = False [, $bVisible = True [, $sPassword = Default [, $sWritePassword = Default [, $bUpdateLinks = Default]]]]] )

Param�tres

$oExcel Objet application Excel o� vous voulez ouvrir le classeur
$sFilePath Chemin et nom du fichier � ouvrir
$bReadOnly [optionnel] True ouvre le classeur en lecture seule (par d�faut, False)
$bVisible [optionnel] True sp�cifie que la fen�tre du classeur sera visible (par d�faut, True)
$sPassword [optionnel] Le mot de passe qui a �t� utilis� pour prot�ger en lecture le classeur, le cas �ch�ant ( par d�faut: pas de protection )
$sWritePassword [optionnel] Le mot de passe qui a �t� utilis� pour prot�ger en �criture le classeur, le cas �ch�ant (par d�faut, pas de protection)
$bUpdateLinks [optionnel] Indique la fa�on dont les r�f�rences externes (liens) du fichier sont mise � jour (par d�faut, Default)
Les valeurs valides sont:
    Par d�faut: Excel demande � l'utilisateur de d�cider comment mettre � jour les liens
.     0: Excel ne met pas � jour les liens
.     3: Excel met � jour tous les liens.

Valeur de retour

Succ�s: Retourne un objet Workbook. @extended est mis � 1 si $bReadOnly = False mais l'acc�s en lecture-�criture ne devrait pas �tre accord�. Voir la section Remarque pour plus de d�tails.
�chec: Retourne 0 et d�finit @error <> 0.
@error: 1 - $oExcel n'est pas un objet ou n'est pas un objet application
2 - Le fichier $sFilePath n'existe pas
3 - Impossible d'ouvrir $sFilePath. @extended contient le code d'erreur COM retourn� par la m�thode Open

Remarque

Si vous d�finissez $bReadOnly � False mais que le document ne peut pas �tre ouvert en lecture-�criture, @error = 1.
Le classeur a �t� ouvert en lecture seule, car il a d�j� �t� ouvert par un autre utilisateur/t�che ou le fichier est en lecture seule par le syst�me de fichiers.
Si vous modifiez le classeur, vous devez utiliser _Excel_BookSaveAs() pour le sauvegarder � un autre endroit ou avec un autre nom.

Lors du r�glage de $bVisible = False lors de l'ouverture d'un classeur, assurez-vous de d�finir de nouveau le classeur � visible avant de sauvegarder le classeur.
Utilisez $oExcel.Windows($oWorkbook.Name).Visible = True pour rendre de nouveau le classeur visible.
Sinon le classeur ne sera pas visible lorsque vous l'ouvrirez manuellement � l'aide d'Excel.
La plupart du temps ce param�tre n'est pas n�cessaire. Utiliser $bVisible = False dans _Excel_Open est le moyen privil�gi�.

Si $bUpdateLinks est d�fini � Default, l'utilisateur est interrog� seulement si $bDisplayAlerts est fix� � True dans la fonction _Excel_Open.
Si $bDisplayAlerts est d�fini � False, Excel choisit la r�ponse par d�faut.

En relation

_Excel_BookAttach, _Excel_BookClose, _Excel_BookNew, _Excel_BookOpenText

Exemple

#include <Excel.au3>
#include <MsgBoxConstants.au3>

; Cr�e un objet Excel
Local $oExcel = _Excel_Open()
If @error Then Exit MsgBox(16, "UDF Excel: _Excel_BookOpen-Exemple", "Erreur lors de la cr�ation de l'objet Excel." & @CRLF & "@error = " & @error & ", @extended = " & @extended)

; *****************************************************************************
; Ouvre un classeur existant et retourne son identifiant d'objet.
; *****************************************************************************
Local $sWorkbook = @ScriptDir & "\Extras\_Excel1.xls"
Local $oWorkbook = _Excel_BookOpen($oExcel, $sWorkbook, Default, Default, True)
If @error Then Exit MsgBox($MB_SYSTEMMODAL, "UDF Excel: _Excel_BookOpen-Exemple", "Erreur lors de l'ouverture de '" & $sWorkbook & "'." & @CRLF & "@error = " & @error & ", @extended = " & @extended)
MsgBox($MB_SYSTEMMODAL, "UDF Excel: _Excel_BookOpen-Exemple", "Le classeur '" & $sWorkbook & "' a �t� ouvert avec succ�s." & @CRLF & @CRLF & "Date de Cr�ation: " & $oWorkbook.BuiltinDocumentProperties("Creation Date").Value)