Поддержка автоматизированного пользовательского интерфейса для элемента управления типа Hyperlink
Примечание.
Эта документация предназначена для разработчиков .NET Framework, желающих использовать управляемые классы автоматизации пользовательского интерфейса, определенные в пространстве имен System.Windows.Automation. Последние сведения об автоматизации пользовательского интерфейса см. в статье API автоматизации Windows. Автоматизация пользовательского интерфейса.
В этом разделе содержатся сведения о поддержке модель автоматизации пользовательского интерфейса типа элемента управления Гиперссылки. В модель автоматизации пользовательского интерфейса тип элемента управления — это набор условий, которые элемент управления должен соответствовать для использования ControlTypeProperty свойства. Условия включают конкретные рекомендации по структуре дерева модель автоматизации пользовательского интерфейса, модель автоматизации пользовательского интерфейса значения свойств и шаблоны элементов управления.
С помощью элементов управления "Гиперссылка" пользователи могут перемещаться по странице, с одной страницы на другую, а также открывать окна.
В следующих разделах определяется необходимая модель автоматизации пользовательского интерфейса структура дерева, свойства, шаблоны элементов управления и события для типа элемента управления Гиперссылка. Требования модель автоматизации пользовательского интерфейса применяются ко всем элементам управления гиперссылками, будь то Windows Presentation Foundation (WPF), Win32 или Windows Forms.
Требуемая древовидная структура модели автоматизации пользовательского интерфейса
В следующей таблице представлено представление элемента управления и представление содержимого дерева модель автоматизации пользовательского интерфейса, относящегося к элементам управления гиперссылками и описывающее, что можно содержать в каждом представлении. Дополнительные сведения о дереве модель автоматизации пользовательского интерфейса см. в модель автоматизации пользовательского интерфейса обзоре дерева.
| Представление элемента управления | Представление содержимого |
|---|---|
| Гиперссылка | Гиперссылка |
Требуемые свойства модели автоматизации пользовательского интерфейса
В следующей таблице перечислены свойства модель автоматизации пользовательского интерфейса, значение или определение которого особенно относится к типу элемента управления Гиперссылки. Дополнительные сведения о свойствах модель автоматизации пользовательского интерфейса см. в разделе модель автоматизации пользовательского интерфейса Свойства для клиентов.
| Свойство модели автоматизации пользовательского интерфейса | Значение | Примечания. |
|---|---|---|
| AutomationIdProperty | См. примечания. | Значение этого свойства должно быть уникальным среди всех элементов управления в приложении. |
| BoundingRectangleProperty | См. примечания. | Внешний прямоугольник, содержащий весь элемент управления. |
| ClickablePointProperty | См. примечания. | Поддерживается при наличии ограничивающего прямоугольника. Если не все точки внутри ограничивающего прямоугольника являются интерактивными и выполняется специализированная проверка на наличие данных, выполните переопределение и предоставьте интерактивную точку. |
| IsKeyboardFocusableProperty | См. примечания. | Если элемент управления может получать фокус клавиатуры, он должен поддерживать это свойство. |
| NameProperty | См. примечания. | Имя элемента управления "Гиперссылка" — это текст, который отображается на экране как подчеркнутый. |
| ClickablePointProperty | См. примечания. | Активная точка элемента управления "Гиперссылка" должна быть точкой, которая при нажатии ее кнопкой мыши запускает гиперссылку. |
| LabeledByProperty | См. примечания. | Если имеется статическая текстовая метка, то данное свойство должно предоставлять ссылку на этот элемент управления. |
| ControlTypeProperty | Гиперссылка | Это значение является одинаковым для всех инфраструктур пользовательского интерфейса. |
| LocalizedControlTypeProperty | "гиперссылка" | Локализованная строка, соответствующая типу элемента управления Hyperlink. |
| IsContentElementProperty | Истина | Элемент управления гиперссылки всегда включается в представление содержимого дерева модель автоматизации пользовательского интерфейса. |
| IsControlElementProperty | Истина | Элемент управления гиперссылкой всегда включается в представление элемента управления дерева модель автоматизации пользовательского интерфейса. |
Необходимые шаблоны и свойства элементов управления модели автоматизации пользовательского интерфейса
В следующей таблице перечислены шаблоны элементов управления модель автоматизации пользовательского интерфейса, которые должны поддерживаться всеми элементами управления гиперссылками. Дополнительные сведения о шаблонах элементов управления см. в разделе UI Automation Control Patterns Overview.
| Шаблон элемента управления/свойство шаблона | Поддержка/значение | Примечания. |
|---|---|---|
| IInvokeProvider | Да | Все элементы управления "Гиперссылка" должны поддерживать шаблон Invoke. |
| IValueProvider | Зависит | Элементы управления "Гиперссылка должны поддерживать шаблон элемента управления Value, когда ссылка содержит информацию, применимую и значимую для пользователя. |
| Value | Например: "https://www...." |
URL-адрес для адреса в Интернете или интрасети адреса является примером гиперссылки, содержащей значимую для пользователя информацию. Однако программная ссылка имеет смысл только для приложения и не рекомендуется для свойства Value. |
Необходимые события модели автоматизации пользовательского интерфейса
В следующей таблице перечислены события модель автоматизации пользовательского интерфейса, которые должны поддерживаться всеми элементами управления гиперссылками. Дополнительные сведения о событиях см. в разделе UI Automation Events Overview.
| событие модель автоматизации пользовательского интерфейса | Поддержка | Примечания. |
|---|---|---|
| InvokedEvent | Обязательное поле | нет |
| Событие изменения свойстваBoundingRectangleProperty | Обязательное поле | нет |
| Событие изменения свойстваIsOffscreenProperty | Обязательное поле | нет |
| Событие изменения свойстваIsEnabledProperty | Обязательное поле | нет |
| AutomationFocusChangedEvent | Обязательное поле | нет |
| StructureChangedEvent | Обязательное поле | нет |