共用方式為


文字控制件類型

本主題提供 文字 控件類型的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 控件模式,則必須支援此事件。

 

概念

UI 自動化控制項類型概觀

UI 自動化概觀