_Excel_BookNew
Beschreibung anzeigen in
Erstellt ein neues Arbeitsbuch (Workbook)
#include <Excel.au3>
_Excel_BookNew ( $oExcel [, $iSheets = Default] )
Parameter
| $oExcel | Excel Anwendungs-Objekt, mit dem das neue Arbeitsbuch erstellt werden soll |
| $iSheets | [optional] Anzahl Arbeistblätter (Worksheets), die in dem neuen Arbeitsbuch erstellt werden sollen (Standard = Schlüsselwort Default = Excel Standardwert). Maximalwert ist 255 |
Rückgabewert
| Erfolg: | Ein neues Arbeitsbuch-Objekt. |
| Fehler: | 0 und setzt @error. |
| @error: | 1 - $oExcel ist kein Objekt oder kein Anwendungs-Objekt. 2 - Fehler beim setzen von SheetsInNewWorkbook auf den Wert von $iSheets. @extended wird auf den COM Fehlercode gesetzt 3 - Fehler zurückgegeben von der Methode Workbooks.Add. @extended wird auf den COM Fehlercode gesetzt 4 - Parameter $iSheets <. 1 oder >. 255 |
Bemerkungen
Es scheint als gäbe es eine Grenze von 255 für die Einstellung SheetsInNewWorkbook.
Verwandte Funktionen
_Excel_BookAttach, _Excel_BookClose, _Excel_BookOpen, _Excel_BookOpenText
Beispiel
#include <Excel.au3>
#include <MsgBoxConstants.au3>
; Erstellt das Anwendungsobjekt
Local $oExcel = _Excel_Open()
If @error Then Exit MsgBox($MB_SYSTEMMODAL, "Excel UDF: _Excel_BookNew Beispiel 1", "Fehler beim Erstellen des Excel-Anwendungsobjekts." & @CRLF & "@error = " & @error & ", @extended = " & @extended)
; Erstellt eine neue Arbeitsmappe mit 2 Arbeitsblättern
_Excel_BookNew($oExcel, 2)
If @error Then Exit MsgBox($MB_SYSTEMMODAL, "Excel UDF: _Excel_BookNew Beispiel 1", "Fehler beim Erstellen der Arbeitsmappe." & @CRLF & "@error = " & @error & ", @extended = " & @extended)
MsgBox($MB_SYSTEMMODAL, "Excel UDF: _Excel_BookNew Beispiel 1", "Arbeitsmappe wurde erfolgreich mit 2 Arbeitsblättern erstellt.")