_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 - Переименовывает активный лист целевой рабочей книги 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) ; Закрываем рабочую книгу