共用方式為

按鈕控制件類型

  • 發行項

本主題提供 Button 控件類型的Microsoft使用者介面自動化支援相關信息。

按鈕是用戶互動以執行動作的物件，例如對話方塊上的 [確定] 和 [取消] 按鈕。 按鈕控制項是公開的簡單控件，因為它會對應至使用者想要完成的單一命令。

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

本主題包含下列各節。

一般樹狀結構

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

控件檢視 內容檢視
  • 按鈕
    • 圖片 （0 或更多）
    • 文字 （0 或更多）
  • 按鈕

 

相關屬性

下表列出UI自動化屬性，其值或定義與實作 Button 控件類型（例如按鈕控制件）的控制項特別相關。 如需 UI 自動化屬性的詳細資訊，請參閱 從 UI 自動化元素擷取屬性。

UI 自動化屬性 價值 筆記
UIA_AcceleratorKeyPropertyId 請參閱附注。 按鈕控制項通常支援快速鍵，讓使用者能夠從鍵盤快速執行按鈕所代表的動作。
UIA_AutomationIdPropertyId 請參閱附注。 在UI自動化樹狀結構的原始檢視中，此屬性的值在所有對等專案之間必須是唯一的。
UIA_BoundingRectanglePropertyId 請參閱附注。 包含整個控件的最外框。
UIA_ClickablePointPropertyId 請參閱附注。 如果有周框，則支援 。 如果周框內的每個點都無法點選，且元素會執行特製化的點擊測試、覆寫並提供可點選的點。
UIA_ControlTypePropertyId 按鈕
UIA_HelpTextPropertyId 請參閱附注。 說明文字應該會指出啟動按鈕的最終結果。 這通常是透過工具提示呈現的相同資訊類型。
UIA_IsContentElementPropertyId 真 按鈕控件必須一律是內容。
UIA_IsControlElementPropertyId 真 按鈕控件一律必須是控件。
UIA_IsKeyboardFocusablePropertyId 請參閱附注。 如果控件可以接收鍵盤焦點，它必須支援這個屬性。
UIA_LabeledByPropertyId 零 按鈕控件會由其內容自我標記。
UIA_LocalizedControlTypePropertyId 請參閱附注。 對應至 Button 控制件類型的當地語系化字串。 默認值為 en-US 或英文 （美國） 的 「button」。。
UIA_NamePropertyId 請參閱附注。 按鈕控制件的名稱是用來為其加上標籤的文字。 每當影像用來標記按鈕時，都必須為按鈕的 Name 屬性提供替代文字。

 

必要的控制件模式

下表列出所有按鈕控制項都必須支援的UI自動化控制件模式。 如需控制樣式的詳細資訊，請參閱 UI 自動化控制樣式概觀。

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

 

必要事件

下表列出需要按鈕控制項才能支援的UI自動化事件。 如需事件的詳細資訊，請參閱 UI 自動化事件概觀。

UI 自動化事件 筆記
UIA_AutomationFocusChangedEventId
UIA_BoundingRectanglePropertyId 屬性變更事件。
UIA_Invoke_InvokedEventId 如果控件支援 Invoke 控件模式，則必須支援此事件。
UIA_IsEnabledPropertyId 屬性變更事件。 如果控件支援 IsEnabled 屬性，則必須支援這個事件。
UIA_IsOffscreenPropertyId 屬性變更事件。 如果控件支援 IsOffscreen 屬性，它就必須支援這個事件。
UIA_NamePropertyId 屬性變更事件。
UIA_StructureChangedEventId
UIA_ToggleToggleStatePropertyId 屬性變更事件。 如果控件支援 切換 控件模式，它必須支援這個事件。

 

概念

UI 自動化控制項類型概觀

UI 自動化概觀