Erstellt ein Array von einer Zeile oder Spalte der aktiven Excel-Datei.
#Include <Excel.au3>
_ExcelReadArray($oExcel, $iStartRow, $iStartColumn, $iNumCells [, $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 wo das einlesen in das Arrays beginnen soll |
| $iStartColumn | Die Spalte der Excel-Tabelle wo das einlesen in das Arrays beginnen soll |
| $iNumCells | Die Anzahl von Zellen die in das Array eingelesen werden sollen |
| $iDirection | [optional] Die Richtung der einzulesenden Zellen in das Array (0=rechts, 1=hinunter) |
| $iIndexBase | [optional] legt fest, ob das erstellte Array als Indexbasis entweder 0 oder 1 besitzt |
Rückgabewert
| Erfolg: | Ein Array mit den festgelegten Zellinhalten |
| Fehler: | 0 und setzt @error |
| @error: | 0 - Kein Fehler |
| 1 - festgelegtes Objekt existiert nicht | |
| 2 - Parameter außerhalb des Bereichs | |
| 3 - ungültige Anzahl von Zelle | |
| 4 - ungültiger Richtungsparameter | |
| @extended: | 0 - Zeile außerhalb des Bereichs |
| 1 - Spalte außerhalb des Bereichs |
Bemerkungen
Keine.
Verwandte Funktionen
Beispiel
; ***************************************************************
; Beispiel 1 - Schreibt in eine Zelle unter Verwendung einer Schleife, liest die Zellen in ein Array ein, zeigt dieses an, dann wird gespeichert und die Datei geschlossen.
; *****************************************************************
#include <Excel.au3>
#include <Array.au3>
Local $oExcel = _ExcelBookNew() ; Erstellt eine neue Excel-Datei und macht diese sichtbar.
For $i = 1 To 5 ; Schleife
_ExcelWriteCell($oExcel, $i, $i, 1) ; Schreibt in 5 Zellen (vertikale Richtung) die Werte 1 bis 5.
Next
For $i = 1 To 5 ; Schleife
_ExcelWriteCell($oExcel, Asc($i), 1, $i + 2) ; Schreibt in 5 Zellen (horizontale Richtung) die Werte 1 bis 5. Asc() wird nur benutzt, um unterscheidbare Werte beim Einlesen zu erhalten.
Next
$aArray1 = _ExcelReadArray($oExcel, 1, 1, 5, 1) ; Senkrecht (vertikal)
$aArray2 = _ExcelReadArray($oExcel, 1, 3, 5) ; Waagerecht (horizontal)
_ArrayDisplay($aArray2, "Waagerecht")
_ArrayDisplay($aArray1, "Senkrecht")
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.