共用方式為

ToolBar 控制項類型

  • 發行項

本主題提供ToolBar控制項類型的 Microsoft 消費者介面自動化支援相關資訊。 工具列控制項可讓使用者啟用應用程式內含的命令和工具。

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

本主題包含下列各節。

一般樹狀結構

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

控制項檢視 內容檢視
  • ToolBar
    • 不同控制項 (0 或更多)
  • ToolBar
    • 不同控制項 (0 或更多)

 

工具列控制項可以包含其子樹內任何類型的控制項。 通常包含按鈕、下拉式方塊與分割按鈕。

相關屬性

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

使用者介面自動化屬性 值 注意
UIA_AutomationIdPropertyId 請參閱備註。 此屬性的值在消費者介面自動化樹狀結構的原始檢視中的所有對等專案之間必須是唯一的。
UIA_BoundingRectanglePropertyId 請參閱備註。 包含整個控制項的最外層矩形。
UIA_ClickablePointPropertyId 請參閱備註。 如果有週框即受支援。 如果周框內的每個點都不可點選，而且元素會執行特製化點擊測試，請覆寫並提供可點選的點。
UIA_ControlTypePropertyId ToolBar 此值與所有使用者介面架構的值相同。
UIA_IsContentElementPropertyId true 工具列控制項一律包含在消費者介面自動化樹狀結構的內容檢視中。
UIA_IsControlElementPropertyId true 工具列控制項一律包含在消費者介面自動化樹狀結構的控制項檢視中。
UIA_IsKeyboardFocusablePropertyId 請參閱備註。 如果控制項可接收鍵盤焦點，就必定支援此屬性。
UIA_LabeledByPropertyId NULL 工具列控制項永遠不會有標籤。
UIA_LocalizedControlTypePropertyId 請參閱備註。 對應至 ToolBar 控制項類型的當地語系化字串。 預設值為 en-US 或英文 (美國) 的「工具列」。
UIA_NamePropertyId 相依 除非在應用程式中使用多個名稱，否則工具列控制項不需要名稱。 如果有一個以上的名稱，每個都必須有一個辨別名稱 (，例如「Formatting」 或 「Outlining」) 。

 

必要的控制項模式

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

控制項模式 支援 備註
IDockProvider 相依 如果工具列可以停駐到畫面的不同部分，它必須支援 Dock 控制項模式。
IExpandCollapseProvider 相依 如果工具列可以展開和折迭以顯示更多專案，它必須支援 ExpandCollapse 控制項模式。
ITransformProvider 相依 如果工具列可以調整大小、旋轉或移動，則必須支援 轉換 控制項模式。

 

必要的事件

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

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

 

概念

UI 自動化控制項類型概觀

UI 自動化概觀