Этюды для программистов Microsoft Word


Информация взята с сайта Microsoft http://msdn.microsoft.com и расположена удобным для работы образом. Перевод автора.

Гиперссылки (Word 2003)

 

Диалог "Edit Hyperlink"

Диалог "Edit Hyperlink" в зависимости от выбранных элементов списка "Link to:" выглядит по разному. Он позволяет вставить ссылку на существующий файл или страницу в сети.

Можно также вставить ссылку на закладку в текущем документе

или адрес электронной почты

 

Объект Hyperlink

Свойства объекта Hyperlink

В следующей таблице приведено краткое описание основных свойств объекта Hyperlink.

Свойство

Тип

Краткое описание

Address

Read/write
String

Возвращает или устанавливает адрес гиперссылки (имя файла, или URL).

EmailSubject

Read/write
String

Возвращает или устанавливает строку "Subject", которая добавляется к адресу.

Это свойство обычно используется с адресами электронной почты. Имеет более высокий приоритет, чем строка "Subject" заданная в адресе.

ExtraInfoRequired

Read-only
Boolean

True, если для разрешение гиперссылки требуется дополнительная информация.

Дополнительную информацию можно задать в аргументе ExtraInfo методов Follow или FollowHyperlink объекта Document. В качестве дополнительной информации могут выступать, например, координаты точки на картинке, содержание формы или имя файла.

Name

Read-only

String

Возвращает имя гиперссылки.

Range

Объект Range

Возвращает объект Range, представляющий часть документа, в которой содержится гиперссылка.

ScreenTip

Read/write
String

Возвращает или устанавливает текст всплывающей подсказки.

Shape

Объект Shape

Возвращает объект Shape.

Если гиперссылка не содержит объект Shape, возникает ошибка.

SubAddress

Read/write String

Возвращает или устанавливает закладку (named location).

Закладка может быть закладкой документа Microsoft Word, именованной ячейкой таблицы Microsoft Excel, именованным объектом базы данных Microsoft Access или номером слайда в презентации Microsoft PowerPoint.

Target

Read/write String

Возвращает или устанавливает имя фрейма или окна загрузки.

TextToDisplay

Read/write String

Возвращает или устанавливает отображаемый текст.

Type

Read-only MsoHyperlinkType

Возвращает тип гиперссылки.

Перечисление MsoHyperlinkType

Перечисление msoHyperlinkType определяет тип гиперссылки.

Константа

Значение

msoHyperlinkInlineShape

2

msoHyperlinkRange

0

msoHyperlinkShape

1

Методы объекта Hyperlink

В следующей таблице приведено краткое описание методов объекта Hyperlink.

Метод

Комментарий

AddToFavorites

Создаёт ярлык для документа или гиперссылки и добавляет его в папку "Избранное" (Favorites).

CreateNewDocument(
FileName,
EditNow,
Overwrite
)

Создаёт новый документ и привязывает его к гиперссылке.

FileName   String. Имя файла.
EditNow    Boolean.
Если True, то новый документ автоматически открывается.
Значение по умолчанию равно True.
Overwrite    Boolean. Если True, и файл с указанным именем существует, то он перезаписывается. Значение по умолчанию равно False.

Delete

Удаляет гиперссылку.

Follow(NewWindow, AddHistory,
ExtraInfo,
Method,
HeaderInfo
)

Происходит разрешение гиперссылки, скачивание и открытие документа. Если документ уже находится в кэше браузера, то открывается кэшированный документ.

Note  Если в ссылке используется ftp протокол, то этот метод открывает документ, а не просто скачивает его на компьютер пользователя.

NewWindow    Optional Variant. Если True, то документ отображается в новом окне. Значение по умолчанию равно False.
AddHistory    Optional Variant. Зарезервирован.
ExtraInfo    Optional Variant.
Строка или массив байтов с дополнительной информацией протокола HTTP для разрешения гиперссылки. Использование ExtraInfo зависит от значения свойства Method.
Method    Optional Variant. Константа из перечисления MsoExtraInfoMethod, указывающая способ использования дополнительной информации.
HeaderInfo    Optional Variant. Строка, задающая заголовок для HTTP запроса. Значение по умолчанию - пустая строка. Несколько строк заголовка могут быть объединены в одну с использованием следующего синтаксиса: "string1" & vbCr & "string2". Строка автоматически конвертируется в ANSI. Переопределяет поля HTTP заголовка, используемого по умолчанию.

Перечисление MsoExtraInfoMethod

Константа

Значение

msoMethodGet

ExtraInfo представляет собой строку, которая добавляется к адресу.

msoMethodPost

ExtraInfo передается как строка с использованием метода POST.

Коллекция Hyperlinks

Свойство Count возвращает число элементов коллекции.

Методы коллекции Hyperlinks

В следующей таблице приведено краткое описание методов коллекции Hyperlinks.

Метод

Комментарий

Add(
Anchor,
Address,
SubAddress,
ScreenTip, TextToDisplay,
Target)

Возвращает созданный объект Hyperlink, который представляет собой новую гиперссылку, добавленную к коллекции, принадлежащей объекту типа Range, Selection или Document.

Anchor   Required Object. Текст или картинка, к которой привязывается гиперссылка.
Address   Optional Variant. Адрес. Может быть адресом электронной почты, адресом в Интернете или именем файла. Microsoft Word не проверяет правильность ссылки при её создании.
SubAddress   Optional Variant. Имя закладки.
ScreenTip   Optional Variant.
Текст всплывающей подсказки. По умолчанию используется значение свойства Address.
TextToDisplay   Optional Variant. Отображаемый текст гиперссылки. Текст или картинка, заданная в свойстве Anchor заменяется на отображаемый текст.
Target   Optional Variant. Имя фрейма или окна, в которое будет загружена гиперссылка.

Item(Index)

Возвращает указанный элемент коллекции.

 

 

Этюды для программистов Microsoft Word. Приложение. Объект Hyperlink.


© 2000-2009 Евгений Ахунджанов, Все Права Сохранены.
www.transcriber.ru | Послать письмо автору