Функция _ExcelSheetAddNew

         Описание функции


_ExcelSheetAddNew

Добавляет новый лист к коллекции листов открытой рабочей книги Excel.

#include <Excel.au3>
_ExcelSheetAddNew($oExcel [, $sName = ""])

Параметры

$oExcel Ссылка на COM-объект "Excel.Application" полученная ранее вызванными _ExcelBookOpen(), _ExcelBookNew(), или _ExcelBookAttach()
$sName [необязательный] Имя нового листа (по умолчанию - имя создаваемого листа "по умолчанию" выбранного в параметрах Excel)

Возвращаемое значение

Успех:Возвращает 1
Ошибка:Возвращает 0, Устанавливает значение флага ошибки @error:
@error:0 - Скрипт завершил работу без ошибок
1 - Ошибка OLE/COM ($oExcel), возможно указанный объект не существует

См. также

Пример

; ********************************************************************************************************
; Пример 1 - Добавление нового листа с именем "Лист созданный скриптом AutoIT" к коллекции листов целевой рабочей книги
; ********************************************************************************************************
#include <Excel.au3>

Local $oExcel = _ExcelBookNew() ; Создаем новую рабочую книгу

ToolTip('Обратите внимание на индикатор активного листа' & @CRLF & "Сейчас скрипт AutoIt создаст новый лист в этой книге")
Sleep(3500) ; Пауза 3,5 сек.

_ExcelSheetAddNew($oExcel, "Лист созданный скриптом AutoIT")

MsgBox(4096, "_ExcelSheetAddNew | Пример 1", "Демонстрация завершена, нажмите ОК")
_ExcelBookSaveAs($oExcel, @TempDir & "\Temp.xls", "xls", 0, 1) ; Сохраняем файл в директории временных файлов, перезаписывая если необходимо.
_ExcelBookClose($oExcel) ; Закрываем рабочую книгу