文字控制項類型

  • 發行項

本主題提供文字控制項類型的 Microsoft 消費者介面自動化支援相關資訊。

文字控制項是基本使用者介面專案，代表螢幕上的一段文字。

下列各節會定義文字控制項類型的必要消費者介面自動化樹狀結構、屬性、控制項模式和事件。 消費者介面自動化需求適用于 UI 架構/平臺整合消費者介面自動化控制項類型和控制項模式支援的所有樹狀結構控制項。

本主題包含下列各節。

一般樹狀結構

下表描述與文字控制項相關的消費者介面自動化樹狀結構的一般控制項和內容檢視，並描述每個檢視中可包含的內容。 如需 UI 自動化樹狀結構的詳細資訊，請參閱 UI 自動化樹狀結構概觀。

控制項檢視 內容檢視
  • Text
  • Text (如果內容)

 

控制項可以單獨用來當做標籤或當做表單上的靜態文字。 它也可以包含在下列其中一個專案的結構中：

文字控制項可能不會出現在消費者介面自動化樹狀結構的內容檢視中，因為文字通常是透過另一個控制項的Name屬性來顯示。 例如，用來標記下拉式方塊控制項的文字會透過控制項的 Name 屬性公開。 因為下拉式方塊控制項位於消費者介面自動化樹狀結構的內容檢視中，所以文字控制項不需要存在。 如果内嵌物件如超連結，文字控制項可能會有內容檢視中的子系。

相關屬性

下表列出與文字控制項特別相關的消費者介面自動化屬性。 如需消費者介面自動化屬性的詳細資訊，請參閱從 消費者介面自動化 Elements 擷取屬性。

使用者介面自動化屬性 值 注意
UIA_AutomationIdPropertyId 請參閱備註。 此屬性的值在消費者介面自動化樹狀結構的原始檢視中，所有對等專案都必須是唯一的。
UIA_BoundingRectanglePropertyId 請參閱備註。 包含整個控制項的最外層矩形。
UIA_ClickablePointPropertyId 請參閱備註。 如果有週框即受支援。 如果周框內的每個點都無法點選，且元素會執行特製化點擊測試，請覆寫並提供可點選的點。
UIA_ControlTypePropertyId Text
UIA_IsContentElementPropertyId 相依 如果文字控制項包含未在另一個控制項的 Name 屬性中公開的資訊，則為內容。
UIA_IsControlElementPropertyId true 文字控制項必須一律為控制項。
UIA_IsKeyboardFocusablePropertyId 請參閱備註。 如果控制項可接收鍵盤焦點，就必定支援此屬性。
UIA_LabeledByPropertyId NULL 文字控制項沒有靜態文字標籤。
UIA_LocalizedControlTypePropertyId 請參閱備註。 對應至 文字 控制項類型的當地語系化字串。 en-US 或英文 (美國) 的預設值為 「text」。
UIA_NamePropertyId 請參閱備註。 文字控制項的名稱可以是它所顯示的文字。 不過，如果控制項也支援 文字 模式，而且文字很廣泛，請勿使用全文檢索內容做為 Name 值。 相反地，請提供較短的 Name 值，衍生自控制項的其他屬性。

 

必要的控制項模式

下表列出文字控制項必須支援的 UI 自動化控制項模式。 如需控制項模式的詳細資訊，請參閱 UI Automation Control Patterns Overview。

控制項模式 支援 備註
IGridItemProvider 相依 如果文字控制項包含在資料表控制項內，則必須支援 GridItem 控制項模式。
ITableItemProvider 相依 如果文字控制項包含在資料表控制項內，則必須支援 TableItem 控制項模式。
ITextProvider 相依 文字應該支援 文字 控制項模式，以取得更好的協助工具;不過，不需要。 當文字有豐富的樣式和屬性 (例如色彩、粗體和斜體) 時，這種文字控制項模式相當有用。
IValueProvider 永不 文字控制項永遠不會支援 Value 控制項模式。 如果文字是可編輯的，則為 [編輯 ] 控制項類型。

 

必要的事件

下表列出文字控制項需要支援消費者介面自動化事件。 如需 UI Automation Events Overview事件的詳細資訊，請參閱

UI 自動化事件 備註
UIA_AutomationFocusChangedEventId
UIA_BoundingRectanglePropertyId 屬性變更事件。
UIA_IsEnabledPropertyId 屬性變更事件。 如果控制項支援 IsEnabled 屬性，它必須支援這個事件。
UIA_IsOffscreenPropertyId 屬性變更事件。 如果控制項支援 IsOffscreen 屬性，它必須支援此事件。
UIA_NamePropertyId 屬性變更事件。
UIA_StructureChangedEventId
UIA_Text_TextChangedEventId 如果控制項支援 文字 控制項模式，它必須支援這個事件。

 

概念

UI 自動化控制項類型概觀

UI 自動化概觀