共用方式為


ToolBar 控件類型

本主題提供 ToolBar 控件類型的Microsoft UI 自動化支援相關信息。 工具列控制項可讓使用者啟用應用程式中包含的命令和工具。

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

本主題包含下列各節。

一般樹狀結構

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

控件檢視 內容檢視
  • 工具列
    • 各種控制項(0 個以上)
  • 工具列
    • 各種控制項(0 個以上)

 

工具列控件可以包含其子樹內的任何類型的控制件。 它們最常包含按鈕、下拉式方塊和分割按鈕。

相關屬性

下表列出UI自動化屬性,其值或定義與 ToolBar 控件類型特別相關。 如需 UI 自動化屬性的詳細資訊,請參閱 從 UI 自動化元素擷取屬性

UI 自動化屬性 價值 筆記
UIA_AutomationIdPropertyId 請參閱附注。 在UI自動化樹狀結構的原始檢視中,此屬性的值在所有對等專案之間必須是唯一的。
UIA_BoundingRectanglePropertyId 請參閱附注。 包含整個控件的最外框。
UIA_ClickablePointPropertyId 請參閱附注。 如果有周框,則支援 。 如果周框內的每個點都無法點選,且元素會執行特製化的點擊測試、覆寫並提供可點選的點。
UIA_ControlTypePropertyId ToolBar 所有UI架構的這個值都相同。
UIA_IsContentElementPropertyId 工具列控件一律包含在UI自動化樹狀結構的內容檢視中。
UIA_IsControlElementPropertyId 工具列控件一律包含在UI自動化樹狀結構的控件檢視中。
UIA_IsKeyboardFocusablePropertyId 請參閱附注。 如果控件可以接收鍵盤焦點,它必須支援這個屬性。
UIA_LabeledByPropertyId 工具列控件永遠不會有標籤。
UIA_LocalizedControlTypePropertyId 請參閱附注。 對應至 ToolBar 控制件類型的當地語系化字串。 預設值為 en-US 或英文 (美國) 的「工具列」。
UIA_NamePropertyId 取決於 除非應用程式內使用多個名稱,否則工具列控件不需要名稱。 如果有多個存在,則每個都必須有辨別名稱(例如,「格式設定」或「大綱」)。

 

必要的控制件模式

下表列出工具列控制項需要支援的UI自動化控制件模式。 如需控制樣式的詳細資訊,請參閱 UI 自動化控制樣式概觀

控制件模式 支援 筆記
IDockProvider 取決於 如果工具列可以停駐到畫面的不同部分,它必須支援 擴充座 控件模式。
IExpandCollapseProvider 取決於 如果工具列可以展開並折疊以顯示更多專案,它必須支援 ExpandCollapse 控制項模式。
ITransformProvider 取決於 如果工具列可以重設大小、旋轉或移動,則必須支援 轉換 控件模式。

 

必要事件

下表列出工具列控制項需要支援的UI自動化事件。 如需事件的詳細資訊,請參閱 UI 自動化事件概觀

UI 自動化事件 筆記
UIA_AutomationFocusChangedEventId
UIA_BoundingRectanglePropertyId 屬性變更事件。
UIA_ExpandCollapseExpandCollapseStatePropertyId 屬性變更事件。 如果控件支援 ExpandCollapse 控件模式,則必須支援此事件。
UIA_IsEnabledPropertyId 屬性變更事件。 如果控件支援 IsEnabled 屬性,則必須支援這個事件。
UIA_IsOffscreenPropertyId 屬性變更事件。 如果控件支援 IsOffscreen 屬性,它就必須支援這個事件。
UIA_StructureChangedEventId

 

概念

UI 自動化控制項類型概觀

UI 自動化概觀