共用方式為


按鈕控制項類型

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

按鈕是可供使用者互動的物件,能在對話方塊執行如 [確定] 和 [取消] 按鈕等動作。 按鈕控制項的公開方式很簡單,因為它對應的是使用者想要完成的單一命令。

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

本主題包含下列各節。

一般樹狀結構

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

控制項檢視 內容檢視
  • 按鈕
    • 影像 (0 個以上)
    • 文字 (0 個以上)
  • 按鈕

 

相關屬性

下表列出消費者介面自動化屬性,其值或定義與實作Button控制項類型的控制項特別相關 (,例如按鈕控制項) 。 如需消費者介面自動化屬性的詳細資訊,請參閱從 消費者介面自動化 Elements 擷取屬性

使用者介面自動化屬性 注意
UIA_AcceleratorKeyPropertyId 請參閱備註。 按鈕控制項通常支援快速鍵,讓使用者能夠從鍵盤快速執行按鈕所代表的動作。
UIA_AutomationIdPropertyId 請參閱備註。 此屬性的值在消費者介面自動化樹狀結構的原始檢視中,所有對等專案都必須是唯一的。
UIA_BoundingRectanglePropertyId 請參閱備註。 包含整個控制項的最外層矩形。
UIA_ClickablePointPropertyId 請參閱備註。 如果有週框即受支援。 如果周框內的每個點都無法點選,且元素會執行特製化點擊測試,請覆寫並提供可點選的點。
UIA_ControlTypePropertyId 按鈕
UIA_HelpTextPropertyId 請參閱備註。 解說文字應該指出啟動按鈕的結束結果。 這通常是透過工具提示呈現的相同類型資訊。
UIA_IsContentElementPropertyId true 按鈕控制項必須一律是內容。
UIA_IsControlElementPropertyId true 按鈕控制項一律必須是控制項。
UIA_IsKeyboardFocusablePropertyId 請參閱備註。 如果控制項可接收鍵盤焦點,就必定支援此屬性。
UIA_LabeledByPropertyId Null 按鈕控制項會自行將其內容設為標籤。
UIA_LocalizedControlTypePropertyId 請參閱備註。 對應至 Button 控制項類型的當地語系化字串。 en-US 或英文 (美國) 的預設值為 「button」。
UIA_NamePropertyId 請參閱備註。 按鈕控制項的名稱是用來為其加上標籤的文字。 每當影像用來標記按鈕時,就必須為按鈕的 Name 屬性提供替代文字。

 

必要的控制項模式

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

控制項模式/模式屬性 支援/值 備註
IExpandCollapseProvider 請參閱備註。 當按鈕裝載為分割按鈕的子系時,子按鈕可以支援 ExpandCollapse 控制項模式,而不是 用或 切換 控制項模式。 ExpandCollapse 控制項模式可用來開啟或關閉功能表或其他與按鈕元素相關聯的子結構。
IInvokeProvider 請參閱備註。 所有按鈕都應該支援 用控制項模式或 切換 控制項模式,但不支援兩者。 當按鈕在使用者要求執行命令時,必須支援叫用控制項模式。 此命令對應於如「剪下」、「複製」、「貼上」或「刪除」等單一作業。
IToggleProvider 請參閱備註。 所有按鈕都應該支援 用控制項模式或 切換 控制項模式,但不支援兩者。 如果按鈕可以迴圈執行一系列最多三種狀態,則必須支援切換控制項模式。 這通常是指特定功能的開關切換。

 

必要的事件

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

UI 自動化事件 備註
UIA_AutomationFocusChangedEventId
UIA_BoundingRectanglePropertyId 屬性變更事件。
UIA_Invoke_InvokedEventId 如果控制項支援 用控制項模式,它必須支援這個事件。
UIA_IsEnabledPropertyId 屬性變更事件。 如果控制項支援 IsEnabled 屬性,它必須支援這個事件。
UIA_IsOffscreenPropertyId 屬性變更事件。 如果控制項支援 IsOffscreen 屬性,它必須支援這個事件。
UIA_NamePropertyId 屬性變更事件。
UIA_StructureChangedEventId
UIA_ToggleToggleStatePropertyId 屬性變更事件。 如果控制項支援 切換 控制項模式,它必須支援這個事件。

 

概念

UI 自動化控制項類型概觀

UI 自動化概觀