Schreibt ein Array in eine Zeile oder Spalte der aktiven Excel-Datei des angegebenen Excel-Objekts.
#Include <Excel.au3>
_ExcelWriteArray($oExcel, $iStartRow, $iStartColumn, $aArray [, $iDirection = 0 [, $iIndexBase = 0]])
Parameter
| $oExcel | Ein Excel-Objekt, welches durch einen vorherigen Aufruf von _ExcelBookOpen() oder _ExcelBookNew() geöffnet wurde |
| $iStartRow | Die Zeile der Excel-Tabelle, in der das Schreiben des Arrays beginnen soll |
| $iStartColumn | Die Spalte der Excel-Tabelle, in der das Schreiben des Arrays beginnen soll |
| $aArray | Das Array, welches in das Tabellenblatt geschrieben werden soll |
| $iDirection | [optional] Die Richtung, in die das Array geschrieben werden soll (0=rechts, 1=hinunter) |
| $iIndexBase | [optional] Legt die Basis des Arrayindizes fest, entweder 0 oder 1 |
Rückgabewert
| Erfolg: | 1 |
| Fehler: | 0 und setzt @error |
| @error: | 0 - Kein Fehler |
| 1 - festgelegtes Objekt existiert nicht | |
| 2 - Parameter außerhalb des Bereichs | |
| 3 - Array existiert nicht / Variable ist kein Array | |
| 4 - ungültiger Richtungsparameter | |
| @extended: | 0 - Zeile außerhalb des Bereichs |
| 1 - Spalte außerhalb des Bereichs |
Bemerkungen
Keine.
Verwandte Funktionen
Beispiel
; ***************************************************************
; Beispiel 1 - Nach dem Öffnen einer Excel-Datei und dem Erhalt der Objekt-ID wird ein Array deklariert und dieses in die Tabelle eingetragen, dann wird gespeichert und die Datei geschlossen.
; *****************************************************************
#include <Excel.au3>
Local $oExcel = _ExcelBookNew() ; Erstellt eine neue Excel-Datei und macht diese sichtbar.
; Deklaration des Arrays
Local $aArray[5] = ["LocoDarwin", "Jon", "big_daddy", "DaleHolm", "GaryFrost"]
_ExcelWriteArray($oExcel, 1, 1, $aArray) ; Schreibt das Array in horizontaler Richtung.
_ExcelWriteArray($oExcel, 5, 1, $aArray, 1) ; Schreibt das Array in vertikaler Richtung, beginnend mit Zeile 5.
MsgBox(0, "Beenden...", "Drücke OK, um die Datei zu speichern und Excel zu beenden.")
_ExcelBookSaveAs($oExcel, @TempDir & "\Temp.xls", "xls", 0, 1) ; Nun wird die Datei in das Temp-Verzeichnis gespeichert. Falls notwendig werden existierende Dateien überschrieben.
_ExcelBookClose($oExcel) ; Und zum Schluss schließen wir die Datei.