Тип элемента управления Гиперссылка
В этом разделе содержатся сведения о поддержке службы автоматизации пользовательского интерфейса Майкрософт для типа элемента управления Гиперссылка.
Элементы управления гиперссылками создают ссылки, позволяющие пользователям перемещаться по одной странице или с одной страницы на другую.
В следующих разделах определяется необходимая структура дерева автоматизации пользовательского интерфейса, свойства, шаблоны элементов управления и события для типа элемента управления Гиперссылка. Требования к автоматизации пользовательского интерфейса применяются ко всем элементам управления гиперссылки, где платформа и платформа пользовательского интерфейса интегрирует поддержку автоматизации пользовательского интерфейса для типов элементов управления и шаблонов элементов управления.
В этом разделе содержатся следующие разделы.
- типичная структура дерева
- соответствующие свойства
- обязательные шаблоны элементов управления
- обязательные события
- примечания
- связанные разделы
Типичная структура дерева
В следующей таблице представлено типичное представление элемента управления и содержимого дерева автоматизации пользовательского интерфейса, относящегося к элементам управления гиперссылкой и описывающее, что можно содержать в каждом представлении. Дополнительные сведения о дереве автоматизации пользовательского интерфейса см. в обзоре дерева автоматизации пользовательского интерфейса.
| Представление элемента управления | Представление содержимого |
|---|---|
|
|
Соответствующие свойства
В следующей таблице перечислены свойства автоматизации пользовательского интерфейса, значение или определение которых особенно важно для элементов управления гиперссылками. Дополнительные сведения о свойствах автоматизации пользовательского интерфейса см. в получения свойств из элементов автоматизации пользовательского интерфейса.
| Свойство автоматизации пользовательского интерфейса | Ценность | Примечания |
|---|---|---|
| UIA_AutomationIdPropertyId | См. заметки. | Значение этого свойства должно быть уникальным для всех элементов управления в приложении. |
| UIA_BoundingRectanglePropertyId | См. заметки. | Самый внешний прямоугольник, содержащий весь элемент управления. |
| UIA_ClickablePointPropertyId | См. заметки. | Точка щелчка элемента управления гиперссылкой должна быть точкой, которая запускает гиперссылку при щелчке указателем мыши. |
| UIA_ControlTypePropertyId | гиперссылки | |
| UIA_IsContentElementPropertyId | ИСТИННЫЙ | Элемент управления гиперссылкой всегда включается в представление содержимого дерева автоматизации пользовательского интерфейса. |
| UIA_IsControlElementPropertyId | ИСТИННЫЙ | Элемент управления гиперссылкой всегда включается в представление элемента управления дерева автоматизации пользовательского интерфейса. |
| UIA_IsKeyboardFocusablePropertyId | См. заметки. | Если элемент управления может получить фокус клавиатуры, он должен поддерживать это свойство. |
| UIA_LabeledByPropertyId | См. заметки. | Если имеется статическое текстовое метка, это свойство должно предоставлять ссылку на этот элемент управления. |
| UIA_LocalizedControlTypePropertyId | См. заметки. | Локализованная строка, соответствующая типу элемента управления гиперссылки. Значение по умолчанию — гиперссылка для en-US или английского языка (США). |
| UIA_NamePropertyId | См. заметки. | Имя элемента управления гиперссылки — это текст, отображаемый на экране как подчеркнутый. |
Обязательные шаблоны элементов управления
В следующей таблице перечислены шаблоны элементов управления автоматизации пользовательского интерфейса, которые требуются для поддержки элементов управления гиперссылками. Дополнительные сведения о шаблонах элементов управления см. в шаблонах элементов управления автоматизации пользовательского интерфейса.
| Управление шаблоном или свойством шаблонов | Поддержка и значение | Примечания |
|---|---|---|
| IInvokeProvider | Обязательно | Все элементы управления гиперссылками должны поддерживать шаблон элемента управления Invoke. |
| IValueProvider | Зависит | Элементы управления гиперссылками должны поддерживать шаблон значения, если ссылка содержит сведения, доступные и значимые для пользователя. |
| значение | Например, "https://www..." | URL-адрес интернета или интрасети — это пример гиперссылки, содержащей сведения, значимые для пользователя. Однако программная ссылка имеет смысл только для приложения и не рекомендуется для свойства Value. |
Обязательные события
В следующей таблице перечислены события автоматизации пользовательского интерфейса, которые требуются для поддержки элементов управления гиперссылками. Дополнительные сведения о событиях см. в обзоре событий автоматизации пользовательского интерфейса.
| Событие автоматизации пользовательского интерфейса | Примечания |
|---|---|
| UIA_AutomationFocusChangedEventId | |
| событие UIA_BoundingRectanglePropertyId изменено свойством. | |
| UIA_Invoke_InvokedEventId | |
| событие UIA_IsEnabledPropertyId изменено свойством. | Если элемент управления поддерживает свойство IsEnabled, он должен поддерживать это событие. |
| событие UIA_IsOffscreenPropertyId изменено свойством. | Если элемент управления поддерживает свойство IsOffscreen, он должен поддерживать это событие. |
| UIA_StructureChangedEventId |
Замечания
Тип элемента управления Гиперссылка должен применяться только к объекту, который при щелчке приводит к возникновению навигации; Он не должен применяться к контейнеру гиперссылки. Например, только щелкаемые "горячие точки" на карте изображений должны иметь тип элемента управления Гиперссылка. То же самое относится к гиперссылкам в текстовом поле или контейнере документов. В этом случае только текст гиперссылки или изображение должны иметь тип элемента управления Гиперссылка, а не контейнер.
Шаблон элемента управления текста идеально подходит для поддержки внедренных гиперссылок в элементах текста или документа.
Связанные разделы
-
концептуальные
-
Общие сведения о типах элементов управления автоматизации пользовательского интерфейса