Функция _ExcelBookOpen

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


_ExcelBookOpen

Открывает существующую рабочую книгу Excel и возвращает экземпляр ее объекта (ссылку на COM объект "Excel.Application").

#include <Excel.au3>
_ExcelBookOpen($sFilePath [, $fVisible = 1 [, $fReadOnly = False [, $sPassword = "" [, $sWritePassword = ""]]]])

Параметры

$sFilePath Путь к рабочей книге Excel (абсолютная ссылка н/п "C:\Documents\myworkbook.xls")
$fVisible [необязательный] Флаг, определяющий отображение открываемой книги (0=невидима, 1=видима)(по умолчанию=1)
$fReadOnly [необязательный] Флаг, определяющий режим открытия книги "только для чтения" (True="только для чтения", False="без ограничений") (по умолчанию=False)
$sPassword [необязательный] Пароль к защищенной паролем рабочей книге (по умолчанию=""(nothing))
$sWritePassword [необязательный] Пароль защиты от редактирования в рабочей книге (по умолчанию=""(nothing))

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

Успех:Возвращает экземпляр объекта созданной рабочей книги Excel
Ошибка:Возвращает 0, Устанавливает значение флага ошибки @error:
@error:0 - Скрипт завершил работу без ошибок
1 - Ошибка вызванная "Excel COM object" ($oExcel), возможно указанный объект не существует
2 - Файл не существует или имеет неправильный формат

См. также

_ExcelBookAttach

Пример

; **********************************************************************************************
; Пример 1 - открывает рабочую книгу Excel, и возвращает экземпляр её объекта переменной $oExcel
; **********************************************************************************************

#include <Excel.au3>

$sFilePath1 = @ScriptDir & "\Test.xls" ;Существующая рабочая книга Excel
$oExcel = _ExcelBookOpen($sFilePath1)

If Not @error Then MsgBox(4096, "_ExcelBookOpen | Пример 1", "Книга открыта!")

If @error = 1 Then
    MsgBox(4096, "Ошибка!", "Ошибка OLE\COM")
    Exit
ElseIf @error = 2 Then
    MsgBox(4096, "Ошибка!", "Файл не существует или имеет неправильный формат!")
    Exit
EndIf