超链接控件类型
本主题提供有关 超链接 控件类型的Microsoft UI 自动化支持的信息。
超链接控件创建链接，使用户可以在同一页中导航，或从一个页面导航到另一个页面。
以下各节定义 超链接 控件类型所需的 UI 自动化树结构、属性、控件模式和事件。 UI 自动化要求适用于 UI 框架/平台集成 UI 自动化对控件类型和控件模式的支持的所有超链接控件。
本主题包含以下部分。
典型树结构
下表描述了与超链接控件相关的 UI 自动化树的典型控件和内容视图，并描述了每个视图中可以包含的内容。 有关 UI 自动化树的详细信息，请参阅 UI 自动化树概述。
| 控件视图 | 内容视图 |
|---|---|
|
|
相关属性
下表列出了其值或定义与超链接控件特别相关的 UI 自动化属性。 有关 UI 自动化属性的详细信息，请参阅 从 UI 自动化元素检索属性。
| UI 自动化属性 | 价值 | 笔记 |
|---|---|---|
| UIA_AutomationIdPropertyId | 请参阅备注。 | 此属性的值在应用程序中的所有控件中必须是唯一的。 |
| UIA_BoundingRectanglePropertyId | 请参阅备注。 | 包含整个控件的最外侧矩形。 |
| UIA_ClickablePointPropertyId | 请参阅备注。 | 超链接控件的可单击点必须是使用鼠标指针单击时启动超链接的点。 |
| UIA_ControlTypePropertyId | 超链接 | |
| UIA_IsContentElementPropertyId | 真 | 超链接控件始终包含在 UI 自动化树的内容视图中。 |
| UIA_IsControlElementPropertyId | 真 | 超链接控件始终包含在 UI 自动化树的控件视图中。 |
| UIA_IsKeyboardFocusablePropertyId | 请参阅备注。 | 如果控件可以接收键盘焦点，它必须支持此属性。 |
| UIA_LabeledByPropertyId | 请参阅备注。 | 如果有静态文本标签，此属性必须公开对该控件的引用。 |
| UIA_LocalizedControlTypePropertyId | 请参阅备注。 | 与超链接 控件类型对应的 本地化字符串。 默认值为 en-US 或英语（美国）的“超链接”。 |
| UIA_NamePropertyId | 请参阅备注。 | 超链接控件的名称是在屏幕上显示为下划线的文本。 |
所需的控件模式
下表列出了支持超链接控件所需的 UI 自动化控件模式。 有关控件模式的详细信息，请参阅 UI 自动化控件模式概述。
| 控件模式/模式属性 | 支持/值 | 笔记 |
|---|---|---|
| IInvokeProvider | 必填 | 所有超链接控件都必须支持 调用 控件模式。 |
| IValueProvider | 取决于 | 当链接包含对用户可用且有意义的信息时，超链接控件应支持 值 控件模式。 |
| 值 | 例如，“https://www..." | Internet 或 Intranet 地址的 URL 是一个超链接示例，其中包含对用户有意义的信息。 但是，编程链接仅对应用程序有意义，不建议对 Value 属性使用。 |
必需事件
下表列出了超链接控件支持所需的 UI 自动化事件。 有关事件的详细信息，请参阅 UI 自动化事件概述。
| UI 自动化事件 | 笔记 |
|---|---|
| UIA_AutomationFocusChangedEventId | |
| UIA_BoundingRectanglePropertyId 属性更改事件。 | |
| UIA_Invoke_InvokedEventId | |
| UIA_IsEnabledPropertyId 属性更改事件。 | 如果控件支持 IsEnabled 属性，则必须支持此事件。 |
| UIA_IsOffscreenPropertyId 属性更改事件。 | 如果控件支持 IsOffscreen 属性，则必须支持此事件。 |
| UIA_StructureChangedEventId |
言论
超链接控件类型应仅应用于单击时导致导航发生的对象;它不应应用于超链接的容器。 例如，只有图像映射中的可单击“热点”应具有 超链接 控件类型。 文本字段或文档容器中的超链接也是如此。 在这种情况下，只有超链接文本或图像应具有 超链接 控件类型，而不是容器。
文本 控件模式非常适合支持文本或文档元素中的嵌入超链接。
相关主题