_ExcelWriteCell
Записывает значение в целевую ячейку активного листа открытой рабочей книги Excel.
#include <Excel.au3>
_ExcelWriteCell($oExcel, $sValue, $sRangeOrRow [, $iColumn = 1])
Параметры
$oExcel | Ссылка на COM-объект "Excel.Application" полученная ранее вызванными _ExcelBookOpen(), _ExcelBookNew(), или _ExcelBookAttach() |
$sValue |
Записываемое значение |
$sRangeOrRow |
Адрес ячейки в формате A1, или номер целевой строки - в случае если адрес целевой ячейки указывается в формате R1C1(номер строки\номер столбца) |
$iColumn |
[необязательный] Номер столбца, если адрес целевой ячейки указывается в формате R1C1(номер строки\номер столбца) (по умолчанию = 1) |
Возвращаемое значение
Успех: | Возвращает 1 |
Ошибка: | Возвращает 0, Устанавливает значение флага ошибки @error: |
@error: | 0 - Скрипт завершил работу без ошибок |
1 - Ошибка OLE/COM ($oExcel), возможно указанный объект не существует | |
2 - Недопустимое значение параметра ($sRangeOrRow) | |
@extended: | 0 - Ошибка в значении строки ($sRangeOrRow) |
1 - Ошибка в значении столбца ($iColumn) |
Примечания
Внимание!!! документы разных форматов MS Office имеют различные ограничения по количеству столбцов и строк:Пример
; ****************************************************************************************
; Пример 1 - Запись данных в ячейку активного листа целевой рабочей книги Excel
; ****************************************************************************************
#include <Excel.au3>
Local $oExcel = _ExcelBookNew() ; Создаем новую рабочую книгу
_ExcelWriteCell($oExcel, "Значение записанное скриптом AutoIt", 1, 1)
MsgBox(4096, "_ExcelWriteCell | Пример 1", "Демонстрация завершена, нажмите ОК")
_ExcelBookSaveAs($oExcel, @TempDir & "\Temp.xls", "xls", 0, 1) ; Сохраняем файл в директории временных файлов, перезаписывая если необходимо.
_ExcelBookClose($oExcel) ; Закрываем рабочую книгу