SplitButton 控制項類型

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

分割按鈕控制項可讓動作在控制項上執行，並展開控制項以查看可執行檔其他可能動作清單。

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

本主題包含下列各節。

一般樹狀結構

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

控制項檢視	內容檢視
SplitButton Image (0 或 1) 文字 (0 或 1) 按鈕 (1 或 2) 功能表 (0 或 1;顯示為支援 ExpandCollapse 模式之子按鈕的子系) MenuItem (1 個以上)	SplitButton 按鈕 (1 或 2) MenuItem (1 個以上)

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

使用者介面自動化屬性	值	注意
UIA_AutomationIdPropertyId	請參閱備註。	此屬性的值在消費者介面自動化樹狀結構的原始檢視中，所有對等專案都必須是唯一的。
UIA_BoundingRectanglePropertyId	請參閱備註。	包含整個控制項的最外層矩形。
UIA_ClickablePointPropertyId	請參閱備註。	如果有週框即受支援。如果周框內的每個點都無法點選，且元素會執行特製化點擊測試，請覆寫並提供可點選的點。
UIA_ControlTypePropertyId	SplitButton	此值與所有使用者介面架構的值相同。
UIA_HelpTextPropertyId	請參閱備註。	說明文字可能指出啟動分割按鈕的結果，而這通常是透過工具提示顯示的相同類型資訊。
UIA_IsContentElementPropertyId	true	分割按鈕控制項包含給使用者的資訊。
UIA_IsControlElementPropertyId	true	使用者可以看到分割按鈕控制項。
UIA_IsKeyboardFocusablePropertyId	請參閱備註。	如果控制項可接收鍵盤焦點，就必定支援此屬性。
UIA_LabeledByPropertyId	NULL	分割按鈕控制項沒有靜態文字標籤。
UIA_LocalizedControlTypePropertyId	請參閱備註。	對應至 SplitButton 控制項類型的當地語系化字串。 en-US 或英文 (美國) 的預設值為「分割按鈕」。
UIA_NamePropertyId	請參閱備註。	用來標記分割按鈕的文字。每當影像用來標記分割按鈕時，就必須為分割按鈕 Name 屬性提供替代文字。

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

控制項模式	支援	備註
IExpandCollapseProvider	必要	因為分割按鈕一律能夠展開選項清單，所以它們必須支援 ExpandCollapse 控制項模式。
IInvokeProvider	必要	因為分割按鈕一律有與 IInvokeProvider：：Invoke 方法相關聯的預設動作，所以它們必須支援 Invoke 控制項模式。

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

UI 自動化事件	備註
UIA_AutomationFocusChangedEventId
UIA_BoundingRectanglePropertyId 屬性變更事件。
UIA_ExpandCollapseExpandCollapseStatePropertyId 屬性變更事件。
UIA_Invoke_InvokedEventId
UIA_IsEnabledPropertyId 屬性變更事件。	如果控制項支援 IsEnabled 屬性，它必須支援這個事件。
UIA_IsOffscreenPropertyId 屬性變更事件。	如果控制項支援 IsOffscreen 屬性，它必須支援這個事件。
UIA_StructureChangedEventId

下圖說明實作 SplitButton 控制項類型的控制項。

顯示分割按鈕控制項範例的螢幕擷取畫面

消費者介面自動化樹狀結構 — 控制項檢視	消費者介面自動化樹狀結構 — 內容檢視
SplitButton "名稱" (Invoke, ExpandCollapse) [更多選項] 按鈕 (叫用) 功能表 MenuItem ...	SplitButton "名稱" (Invoke, ExpandCollapse) [更多選項] 按鈕 (叫用) 功能表 MenuItem ...