UI 自動化控制項類型概觀

Microsoft 消費者介面自動化控制項類型是做為已知識別碼的屬性,表示特定 UI 元素所代表的控制項類型,例如下拉式方塊或按鈕。 用戶端應用程式會使用 類型來識別控制項的功能,並判斷如何與其互動。

本主題包含下列幾節:

UI 自動化控制項類型必要條件

每個消費者介面自動化控制項類型都有一組與其相關聯的條件。 當提供者將控制項類型指派給控制項時,提供者必須確定控制項符合與該控制項類型相關聯的所有條件。 條件包括下列各項:

  • 消費者介面自動化控制項模式:每個控制項類型都有一組控制項必須支援的控制項模式、選用的集合,以及控制項不得支援的集合。
  • 使用者介面自動化屬性值:每個控制項類型都有一組控制項必須支援的屬性。
  • 使用者介面自動化事件:每個控制項類型都有一組控制項必須支援的事件。
  • 使用者介面自動化樹狀結構:每個控制項類型皆定義控制項在使用者介面自動化樹狀結構中必須如何顯示。

當控制項符合特定控制項類型的條件時, IUIAutomationElement::CurrentControlType (或 IUIAutomationElement::CachedControlType) 屬性值會指出該控制項類型。

如果您的控制項不符合特定控制項類型的規格,請使用 UIA_CustomControlTypeId 作為控制項類型識別碼,並使用相關的控制項模式和屬性完全描述控制項。 您也可以將 UIA_LocalizedControlTypePropertyId 屬性設定為最能描述控制項類型的字串。

LocalizedControlType 屬性

如果您使用預先定義的控制項類型來描述控制項,請使用UIA_LocalizedControlTypePropertyId屬性的預設值,並允許消費者介面自動化提供當地語系化字串給提供者正確公開。 如果您無法使用預先定義的控制項類型來描述控制項,請將 UIA_LocalizedControlTypePropertyId 屬性設定為正確描述控制項類型的當地語系化字串。 字串應該簡潔且精確,足以讓螢幕助讀程式之類的輔助技術在 UI 中使用它,以通知使用者控制項的類型。

目前 UI 自動化控制項類型

下列主題描述消費者介面自動化控制項類型。 針對每個控制項類型,描述包含指定類型控制項必須支援的一組條件:

參考

控制項類型識別碼

概念

支援消費者介面自動化控制項類型

標準控制項的 UI 自動化支援

UI 自動化基礎