文字控制件類型
本主題提供 文字 控件類型的Microsoft使用者介面自動化支持相關信息。
文字控制項是基本的使用者介面專案,代表螢幕上的一段文字。
下列各節會定義 Text 控件類型所需的 UI 自動化樹狀結構、屬性、控制樣式和事件。 使用者介面自動化需求適用於所有樹狀控件,其中UI架構/平臺會整合控件類型和控件模式的UI自動化支援。
本主題包含下列各節。
一般樹狀結構
下表描述與文字控件相關的UI自動化樹狀結構的一般控件和內容檢視,並描述每個檢視中可包含的內容。 如需 UI 自動化樹狀結構的詳細資訊,請參閱 UI 自動化樹狀結構概觀。
控件檢視 | 內容檢視 |
---|---|
|
|
文字控制項可以單獨做為標籤或表單上的靜態文字使用。 它也可以包含在下列其中一個項目的結構中:
文字控制項可能不會出現在UI自動化樹狀結構的內容檢視中,因為文字通常會透過另一個控件的 Name 屬性來顯示。 例如,用來標記下拉式方塊控件的文字會透過控件的 Name 屬性公開。 由於下拉式方塊控件位於UI自動化樹狀結構的內容檢視中,因此文字控件不需要存在。 如果有內嵌的物件,文字控件在內容檢視中可能有子系,例如超連結。
相關屬性
下表列出UI自動化屬性,其值或定義與文字控件特別相關。 如需 UI 自動化屬性的詳細資訊,請參閱 從 UI 自動化元素擷取屬性。
UI 自動化屬性 | 價值 | 筆記 |
---|---|---|
UIA_AutomationIdPropertyId | 請參閱附注。 | 在UI自動化樹狀結構的原始檢視中,此屬性的值在所有對等專案之間必須是唯一的。 |
UIA_BoundingRectanglePropertyId | 請參閱附注。 | 包含整個控件的最外框。 |
UIA_ClickablePointPropertyId | 請參閱附注。 | 如果有周框,則支援 。 如果周框內的每個點都無法點選,且元素會執行特製化的點擊測試、覆寫並提供可點選的點。 |
UIA_ControlTypePropertyId | 文字 | |
UIA_IsContentElementPropertyId | 取決於 | 如果文字控制項包含另一個控件的 Name 屬性中未公開的資訊,則文字控件是內容。 |
UIA_IsControlElementPropertyId | 真 | 文字控件一律必須是 控件。 |
UIA_IsKeyboardFocusablePropertyId | 請參閱附注。 | 如果控件可以接收鍵盤焦點,它必須支援這個屬性。 |
UIA_LabeledByPropertyId | 零 | 文字控制件沒有靜態文字標籤。 |
UIA_LocalizedControlTypePropertyId | 請參閱附注。 | 對應至 Text 控制項類型的當地語系化字串。 en-US 或英文的預設值為 「text」。 |
UIA_NamePropertyId | 請參閱附注。 | 文字控制件的名稱可以是它所顯示的文字。 不過,如果控件也支援 文字 模式,而且文字很廣泛,請勿使用全文檢索內容做為 Name 值。 相反地,請提供 Name 值,該值衍生自控件的其他屬性。 |
必要的控制件模式
下表列出文字控制項需要支援的UI自動化控制件模式。 如需控制樣式的詳細資訊,請參閱 UI 自動化控制樣式概觀。
控制件模式 | 支援 | 筆記 |
---|---|---|
IGridItemProvider | 取決於 | 如果文字控制項包含在數據表控件內,則必須支援 GridItem 控制件模式。 |
ITableItemProvider | 取決於 | 如果文字控制項包含在數據表控件內,則必須支援 TableItem 控制件模式。 |
ITextProvider | 取決於 | 文字應該支援 文字 控件模式,以取得更好的輔助功能;不過,並非必要。 當文字具有豐富的樣式和屬性時,文字控件模式很有用(例如色彩、粗體和斜體)。 |
IValueProvider | 從不 | 文字控件絕不支援 Value 控件模式。 如果文字是可編輯的,則為 [編輯] 控件類型。 |
必要事件
下表列出文字控制項需要支援的UI自動化事件。 如需事件的詳細資訊,請參閱 UI 自動化事件概觀。
UI 自動化事件 | 筆記 |
---|---|
UIA_AutomationFocusChangedEventId | |
UIA_BoundingRectanglePropertyId 屬性變更事件。 | |
UIA_IsEnabledPropertyId 屬性變更事件。 | 如果控件支援 IsEnabled 屬性,則必須支援這個事件。 |
UIA_IsOffscreenPropertyId 屬性變更事件。 | 如果控件支援 IsOffscreen 屬性,它就必須支援這個事件。 |
UIA_NamePropertyId 屬性變更事件。 | |
UIA_StructureChangedEventId | |
UIA_Text_TextChangedEventId | 如果控件支援 Text 控件模式,則必須支援此事件。 |
相關主題