Тип элемента управления "Гиперссылка"

В этом разделе содержатся сведения о поддержке microsoft модель автоматизации пользовательского интерфейса для типа элемента управления Гиперссылка.

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

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

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

• Типичная древовидная структура
• Соответствующие свойства
• Обязательные шаблоны элементов управления
• Обязательные события
• Замечания
• Связанные темы

Типичная древовидная структура

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

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

 

Соответствующие свойства

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

Свойство модели автоматизации пользовательского интерфейса	Значение	Примечания
UIA_AutomationIdPropertyId	См. примечания.	Значение этого свойства должно быть уникальным для всех элементов управления в приложении.
UIA_BoundingRectanglePropertyId	См. примечания.	Внешний прямоугольник, содержащий весь элемент управления.
UIA_ClickablePointPropertyId	См. примечания.	Щелкаемая точка элемента управления гиперссылкой должна быть точкой, которая запускает гиперссылку при щелчке указателем мыши.
UIA_ControlTypePropertyId	Гиперссылка
UIA_IsContentElementPropertyId	TRUE	Элемент управления гиперссылкой всегда включается в представление содержимого дерева модель автоматизации пользовательского интерфейса.
UIA_IsControlElementPropertyId	TRUE	Элемент управления гиперссылкой всегда включается в представление элемента управления дерева модель автоматизации пользовательского интерфейса.
UIA_IsKeyboardFocusablePropertyId	См. примечания.	Если элемент управления может получать фокус клавиатуры, он должен поддерживать это свойство.
UIA_LabeledByPropertyId	См. примечания.	При наличии статической текстовой метки это свойство должно предоставлять ссылку на этот элемент управления.
UIA_LocalizedControlTypePropertyId	См. примечания.	Локализованная строка, соответствующая типу элемента управления Гиперссылка . Значение по умолчанию — гиперссылка для en-US или english (США).
UIA_NamePropertyId	См. примечания.	Имя элемента управления гиперссылкой — это текст, который отображается на экране в подчеркнутом виде.

 

Обязательные шаблоны элементов управления

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

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

 

Обязательные события

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

Событие модель автоматизации пользовательского интерфейса	Примечания
UIA_AutomationFocusChangedEventId
UIA_BoundingRectanglePropertyId событие изменения свойства.
UIA_Invoke_InvokedEventId
UIA_IsEnabledPropertyId событие изменения свойства.	Если элемент управления поддерживает свойство IsEnabled , он должен поддерживать это событие.
UIA_IsOffscreenPropertyId событие изменения свойства.	Если элемент управления поддерживает свойство IsOffscreen , он должен поддерживать это событие.
UIA_StructureChangedEventId

 

Комментарии

Тип элемента управления Гиперссылка должен применяться только к объекту, который при щелчке вызывает навигацию; Он не должен применяться к контейнеру гиперссылки. Например, только доступные для щелчка "горячие точки" внутри карты изображений должны иметь тип элемента управления Гиперссылка . То же самое относится к гиперссылкам в текстовом поле или контейнере документов. В этом случае только текст гиперссылки или изображение должны иметь тип элемента управления Гиперссылка , а не контейнер.

Шаблон элемента управления Текст идеально подходит для поддержки внедренных гиперссылок в элементы текста или документа.

Связанные темы

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

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

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