Поддержка автоматизированного пользовательского интерфейса для элемента управления типа Hyperlink

Примечание
Эта документация предназначена для разработчиков на платформе .NET Framework, которым требуется использовать управляемые классы UI Automation, определенные в пространстве имен System.Windows.Automation.Последние сведения о UI Automation см. на веб-странице Windows Automation API: UI Automation.

В этом разделе содержатся сведения о поддержке моделью UI Automation элемента управления типа Hyperlink. В UI Automation тип элемента управления представляет собой набор условий, которым элемент управления должен удовлетворять, чтобы использовать свойство ControlTypeProperty. К этим условиям относятся конкретные правила для древовидной структуры UI Automation, значений свойств UI Automation и шаблонов элементов управления.

Элемент управления Hyperlink позволяет пользователю перемещаться по странице, переходить от одной страницы к другой, и открывать окна.

В следующих разделах определяется необходимая древовидная структура UI Automation, свойства, шаблоны элементов управления и события для типа элемента управления Hyperlink. Требования UI Automation применяются ко всем элементам управления Hyperlink: Windows Presentation Foundation (WPF), Win32 и Windows Forms.

В этом разделе содержатся следующие подразделы.

• Требуемая древовидная структура модели автоматизации пользовательского интерфейса
• Обязательные свойства автоматизации пользовательского интерфейса
• Обязательные шаблоны и свойства элементов управления модели автоматизации пользовательского интерфейса
• Обязательные события модели автоматизации пользовательского интерфейса
• Связанные разделы

Требуемая древовидная структура модели автоматизации пользовательского интерфейса

В следующей таблице описывается представление элемента управления и представление содержимого для дерева UI Automation, которые соответствует элементам управления типа Hyperlink, а также возможное содержимое в каждом представлении. Дополнительные сведения о дереве UI Automation см. в разделе Общие сведения о дереве модели автоматизации пользовательского интерфейса.

Представление элементов управления	Представление содержимого
Гиперссылка	Гиперссылка

Обязательные свойства автоматизации пользовательского интерфейса

В следующей таблице перечислены свойства UI Automation, значение или определение которых относится к элементам управления типа Hyperlink. Дополнительные сведения о свойствах UI Automation см. в разделе Свойства автоматизации пользовательского интерфейса для клиентов.

Свойство UI Automation	Значение	Примечания
AutomationIdProperty	См. примечания.	Значение этого свойства должно быть уникальным для каждого элемента управления в приложении.
BoundingRectangleProperty	См. примечания.	Внешний прямоугольник, содержащий весь элемент управления.
ClickablePointProperty	См. примечания.	Поддерживается при наличии ограничивающего прямоугольника. Если выполняется специализированная проверка нажатия и не все точки внутри ограничивающего прямоугольника можно выбрать с помощью мыши, то следует выполнить переопределение и указать точку, которую можно выбрать с помощью мыши.
IsKeyboardFocusableProperty	См. примечания.	Если элемент управления может получать фокус клавиатуры, он должен поддерживать это свойство.
NameProperty	См. примечания.	Имя элемента управления Hyperlink является текстом, который на экране отображается как подчеркнутый.
ClickablePointProperty	См. примечания.	Активной точкой элемента управления Hyperlink должна быть точка, которая запускает гиперссылку, если гиперссылка выбрана указателем мыши.
LabeledByProperty	См. примечания.	При наличии статической текстовой подписи это свойство должно предоставлять ссылку на этот элемент управления.
ControlTypeProperty	Гиперссылка	Это значение одинаково для всех структур UI.
LocalizedControlTypeProperty	"гиперссылка"	Локализованная строка, соответствующая типу элемента управления Hyperlink.
IsContentElementProperty	True	Элемент управления Hyperlink всегда включается в представление содержимого дерева UI Automation.
IsControlElementProperty	True	Элемент управления HyperLink всегда включается в представление элемента управления дерева UI Automation.

Обязательные шаблоны и свойства элементов управления модели автоматизации пользовательского интерфейса

В следующей таблице перечислены шаблоны элементов управления UI Automation, которые должны поддерживаться элементами управления типа Hyperlink. Дополнительные сведения о шаблонах элементов управления см. в разделе Общие сведения о шаблонах элементов управления модели автоматизации пользовательского интерфейса.

Шаблон элемента управления/свойство шаблона	Поддержка / значение	Примечания
IInvokeProvider	Да	Все элементы управления Hyperlink должны поддерживать шаблон вызова.
IValueProvider	Зависит от конкретного случая	Когда ссылка содержит информацию, применимую и значимую для пользователя, элементы управления Hyperlink должны поддерживать шаблон элемента управления Value.
Value	Например, "http://www...."	Примером гиперссылки, содержащей информацию, значимую для пользователя, является URL-адрес, соответствующий адресу в Интернете или интрасети. Программная ссылка, однако, значима только для приложения. Для свойства Value она не рекомендуется.

Обязательные события модели автоматизации пользовательского интерфейса

В следующей таблице перечислены события UI Automation, для которых требуется поддержка всеми элементами управления типа Hyperlink. Дополнительные сведения о событиях см. в разделе Обзор событий автоматизации пользовательского интерфейса.

Событие UI Automation	Поддержка	Примечания
InvokedEvent	Обязательно	Нет
Событие, изменяемое свойством BoundingRectangleProperty.	Обязательно	Нет
Событие, изменяемое свойством IsOffscreenProperty.	Требуется	Нет
Событие, изменяемое свойством IsEnabledProperty.	Обязательно	Нет
AutomationFocusChangedEvent	Обязательно	Нет
StructureChangedEvent	Обязательно	Нет

См. также

Ссылки

Hyperlink

Основные понятия

Общие сведения о типах элементов управления автоматизации пользовательского интерфейса

Общие сведения о модели автоматизации пользовательского интерфейса