_WordDocAddLink
Добавляет гиперссылку в документ
#include <Word.au3>
_WordDocAddLink(ByRef $o_object [, $o_Anchor = "" [, $s_Address = "" [, $s_SubAddress = "" [, $s_ScreenTip = "" [, $s_TextToDisplay = "" [, $s_Target = ""]]]]]])
Параметры
$o_object | Переменная объекта документа Word.Application |
$o_Anchor |
[необязательный] Текст или графика, который вы хотите сделать гиперссылкой. "" = (по умолчанию) Использует весь документ как диапазон |
$s_Address |
[необязательный] Адрес ссылки. Адресом может быть e-mail, интернет ссылка или, путь к файлу. "" = (по умолчанию) Link to the specified document is used |
$s_SubAddress |
[необязательный] The name of a location within the destination file, such as a bookmark, named range, or slide number. |
$s_ScreenTip |
[необязательный] Текст, который появляется как всплывающая подсказка, когда указатель мыши находится над указанной гиперссылкой. "" = (по умолчанию) Использует значение $s_Address |
$s_TextToDisplay |
[необязательный] The display text of the specified hyperlink. The value of this argument replaces the text or graphic specified by Anchor. "" = (по умолчанию) Использует значение $s_Address |
$s_Target |
[необязательный] The name of the frame or window in which you want to load the specified hyperlink. |
Возвращаемое значение
Успех: | Возвращает 1 |
Ошибка: | Возвращает 0 и устанавливает @error = 1 |
@error: | $_WordStatus_Success = Нет ошибок |
$_WordStatus_InvalidDataType = Неверный тип данных | |
$_WordStatus_InvalidObjectType = Неверный тип объекта | |
@extended: | Содержит номер неисправного параметра |
Пример
; *******************************************************
; Пример 1 - Create a word window with a new blank document,
; add a link, then get a collection of links.
; *******************************************************
#include <Word.au3>
$oWordApp = _WordCreate ()
$oDoc = _WordDocGetCollection ($oWordApp, 0)
_WordDocAddLink ($oDoc, "", "www.AutoIt3.com", "", "AutoIt" & @CRLF, "Link to AutoIt")
$oLinks = _WordDocLinkGetCollection ($oDoc)
MsgBox(4096, "Link Count", @extended)