Функция _ExcelSheetNameSet

_ExcelSheetNameSet

Переименовывает активный лист открытой рабочей книги Excel.

#include <Excel.au3>
_ExcelSheetNameSet($oExcel, $sSheetName)

Параметры

$oExcel	Ссылка на COM-объект "Excel.Application" полученная ранее вызванными _ExcelBookOpen(), _ExcelBookNew(), или _ExcelBookAttach()
$sSheetName	Новое имя листа

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

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

Примечания

Внимание!!! в MS Office Excel существуют ограничение для доступных имен листа рабочей книги:
1) Имя не должно содержать символов /\?*[]:
2) Количество символов в имени не должно превышать 31
3) Имя не является пустой строкой ""
---------------------------------------------------------------
Внимание!!! В MS Ofiice Excel целые положительные числа могут быть именем листа (н\п "1").
Этот метод воспринимает целые положительные числа переданные в параметр $vSheet как порядковый номер листа в коллекции листов целевой рабочей книги, все остальные значения воспринимаются как имя листа.
Будьте внимательны при работе с листами, именем которых являются целые положительные числа.

Пример

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

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

MsgBox(4096, "_ExcelSheetNameGet", "Имя активного листа: " & @CRLF & '"' & _ExcelSheetNameGet($oExcel) & '"')

_ExcelSheetNameSet($oExcel, "Переименован скриптом AutoIt") ; Переименовываем активный лист, присваивая ему имя: "Пример"

MsgBox(4096, "_ExcelSheetNameGet", "А теперь имя активного листа: " & @CRLF & '"' & _ExcelSheetNameGet($oExcel) & '"')

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