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


_ExcelHyperlinkInsert

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

#include <Excel.au3>
_ExcelHyperlinkInsert($oExcel, $sLinkText, $sAddress, $sScreenTip, $sRangeOrRow [, $iColumn = 1])

Параметры

$oExcel Ссылка на COM-объект "Excel.Application" полученная ранее вызванными _ExcelBookOpen(), _ExcelBookNew(), или _ExcelBookAttach()
$sLinkText Отображаемый текст гиперссылки
$sAddress URL на который перенаправляет гиперссылка
$sScreenTip Текст сноски, отображаемый во всплывающем окне при наведении указателя мыши на гиперссылку
$sRangeOrRow Адрес ячейки в формате A1, или номер целевой строки - в случае если адрес целевой ячейки указывается в формате R1C1
$iColumn [необязательный] Номер столбца, если адрес целевой ячейки указывается в формате R1C1(номер строки\номер столбца) (по умолчанию = 1)

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

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

Примечания

Внимание!!! документы разных форматов MS Office Excel имеют различные ограничения по количеству столбцов и строк:
*.xls (формат xlExcel8, стандартный для MS Office 2003,97,95) имеет ограничения в 255 столбцов 65 535 строк
*.xlsx,*.xlsb,*.xlsm (XML-форматы MS Office 2007-2010) имеют ограничения в 16 384 столбца и 1 048 576 строк

Пример

; *********************************************
; Пример 1 - Запись гиперссылки в целевую ячейку
; *********************************************
#include <Excel.au3>

Local $oExcel = _ExcelBookNew() ;Создаем новую рабочую книгу
ToolTip("_ExcelHyperlinkInsert | Пример 1")
Sleep(3000) ; Пауза 3 сек.

$sLinkText = "Перевод офф.справки по AutoIT на русский язык" ;Отображаемый текст гиперссылки
$sAddress = "http://forum.oszone.net/thread-143695-1.html" ;URL на который направляет гиперссылка
$sScreenTip = "Работали над переводом..." ; Текст сноски отображаемой во всплывающем окне при наведении указателя мыши на гиперссылку

_ExcelHyperlinkInsert($oExcel, $sLinkText, $sAddress, $sScreenTip, 2, 1) ;добавление гиперссылки в ячейку с координатами строка:2 столбец:1