StatusBar 控制項類型

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

狀態列控制項可以顯示多項資訊：在應用程式的視窗中檢視的物件、物件的元件，或是與物件的作業相關的內容資訊。

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

本主題包含下列各節。

• 一般樹狀結構
• 相關屬性
• 必要的控制項模式
• 必要的事件
• 備註
• 相關主題

一般樹狀結構

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

控制項檢視	內容檢視
StatusBar 編輯 (0 個以上) 進度列 (0 個以上) 影像 (0 個以上) 按鈕 (0 個以上)	StatusBar 編輯 (0 個以上) 進度列 (0 個以上) 影像 (0 個以上) 按鈕 (0 個以上)

 

相關屬性

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

使用者介面自動化屬性	值	注意
UIA_AutomationIdPropertyId	請參閱備註。	此屬性的值在消費者介面自動化樹狀結構的原始檢視中，所有對等專案都必須是唯一的。
UIA_BoundingRectanglePropertyId	請參閱備註。	狀態列的週框必須框住其中所有控制項。
UIA_ClickablePointPropertyId	請參閱備註。	如果有週框即受支援。 如果周框內有無法點選的區域，而且元素會執行特製化點擊測試，請覆寫此專案，並提供可點選的點。
UIA_ControlTypePropertyId	StatusBar
UIA_IsContentElementPropertyId	true	狀態列控制項一律包含在消費者介面自動化樹狀結構的內容檢視中。
UIA_IsControlElementPropertyId	true	狀態列控制項一律包含在消費者介面自動化樹狀結構的控制項檢視中。
UIA_IsKeyboardFocusablePropertyId	相依	如果控制項可接收鍵盤焦點，就必定支援此屬性。
UIA_IsOffscreenPropertyId	相依	如果目前看不到狀態列控制項，此屬性會傳回 TRUE。
UIA_LabeledByPropertyId	NULL	狀態列控制項通常沒有標籤。
UIA_LocalizedControlTypePropertyId	請參閱備註。	對應至 StatusBar 控制項類型的當地語系化字串。 預設值為 en-US 或英文 (美國) 的狀態列。
UIA_NamePropertyId	請參閱備註。	除非應用程式使用一個以上的狀態列，否則狀態列不需要名稱。 在此情況下，請區分每個列的名稱，例如「網際網路狀態」或「應用程式狀態」。
UIA_OrientationPropertyId	相依	值，表示控制項的方向：水準或垂直。

 

必要的控制項模式

下表列出狀態列控制項所需的消費者介面自動化控制項模式。 如需控制項模式的詳細資訊，請參閱 UI Automation Control Patterns Overview。

控制項模式	支援	備註
IGridProvider	選擇性	狀態列控制項應該支援 方格 控制項模式，以便監視個別片段，並輕鬆地參考資訊。

 

必要的事件

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

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

 

備註

建議編輯控制項當做狀態列中的子格線元素使用。 使用編輯控制項可讓您更輕鬆地使用元素名稱和值屬性，將狀態欄位的用途與其值產生關聯。 因為文字控制項不應該支援 Value 控制項模式，所以不應該當做子格線元素使用。

相關主題

概念

UI 自動化控制項類型概觀

UI 自動化概觀