UDF > Excel >


_Excel_BookNew

Cr�e un nouveau classeur

#include <Excel.au3>
_Excel_BookNew ( $oExcel [, $iSheets = Default] )

Param�tres

$oExcel Objet application Excel dans lequel le nouveau classeur sera cr��
$iSheets [optionnel] Nombre de feuilles � cr�er dans le nouveau classeur (par d�faut, Default, la valeur par d�faut d'Excel). Maximum 255

Valeur de retour

Succ�s: Retourne un nouvel objet Classeur.
�chec: Retourne 0 et d�finit @error <> 0.
@error: 1 - $oExcel n'est pas un objet ou n'est pas un objet Application
2 - Erreur SheetsInNewWorkbook dans $iSheets. @extended contient le code d'erreur COM
3 - Erreur renvoy�e par la m�thode Workbooks.Add. @extended contient le code d'erreur COM
4 - Param�tre $iSheets < 1 ou > 255

Remarque

Il semble y avoir une limite pour la propri�t� SheetsInNewWorkbook fix�e � 255.

En relation

_Excel_BookAttach, _Excel_BookClose, _Excel_BookOpen, _Excel_BookOpenText

Exemple

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

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

; *****************************************************************************
; Cr�e un nouveau classeur avec seulement 2 feuilles
; *****************************************************************************
_Excel_BookNew($oExcel, 2)
If @error Then Exit MsgBox($MB_SYSTEMMODAL, "UDF Excel: _Excel_BookNew-Exemple 1", "Erreur lors de la cr�ation du nouveau classeur." & @CRLF & "@error = " & @error & ", @extended = " & @extended)
MsgBox($MB_SYSTEMMODAL, "UDF Excel: _Excel_BookNew-Exemple 1", "Le classeur a �t� cr�� avec succ�s avec seulement deux feuilles.")