_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 имеют различные ограничения по количеству столбцов и строк:Пример
; *********************************************
; Пример 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