超連結控制項類型
本主題提供 Hyperlink 控件類型的Microsoft使用者介面自動化支持相關信息。
超連結控制項會建立連結，讓使用者在相同的頁面內巡覽，或從一個頁面流覽到另一個頁面。
下列各節會定義 Hyperlink 控件類型所需的 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 或英文 （美國） 的預設值為 「hyperlink」。。 |
| UIA_NamePropertyId | 請參閱附注。 | 超連結控件的名稱是畫面上顯示為底線的文字。 |
必要的控制件模式
下表列出需要超連結控制項才能支援的UI自動化控制件模式。 如需控制樣式的詳細資訊，請參閱 UI 自動化控制樣式概觀。
| 控制件模式/模式屬性 | 支援/值 | 筆記 |
|---|---|---|
| IInvokeProvider | 必填 | 所有超連結控制項都必須支援 叫用 控件模式。 |
| IValueProvider | 取決於 | 當連結包含使用者可用且有意義的資訊時，超連結控件應該支援 Value 控件模式。 |
| 值 | 例如， “https://www..." | 因特網或內部網路位址的 URL 是超連結的範例，其中包含對使用者有意義的資訊。 不過，程式設計連結只對應用程式有意義，不建議 Value 屬性使用。 |
必要事件
下表列出需要超連結控制項才能支援的UI自動化事件。 如需事件的詳細資訊，請參閱 UI 自動化事件概觀。
| UI 自動化事件 | 筆記 |
|---|---|
| UIA_AutomationFocusChangedEventId | |
| UIA_BoundingRectanglePropertyId 屬性變更事件。 | |
| UIA_Invoke_InvokedEventId | |
| UIA_IsEnabledPropertyId 屬性變更事件。 | 如果控件支援 IsEnabled 屬性，則必須支援這個事件。 |
| UIA_IsOffscreenPropertyId 屬性變更事件。 | 如果控件支援 IsOffscreen 屬性，它就必須支援這個事件。 |
| UIA_StructureChangedEventId |
言論
超連結控件類型應該只套用至按兩下時會導致巡覽的物件;它不應該套用至超連結的容器。 例如，只有影像地圖內可點選的「作用點」應該具有 Hyperlink 控件類型。 文字欄位或檔案容器中的超連結也是如此。 在此情況下，只有超連結文字或影像應該具有 Hyperlink 控件類型，而不是容器。
文字 控件模式非常適合支援文字或文件元素中的內嵌超連結。
相關主題