共用方式為

TitleBar 控制項類型

  • 發行項

本主題提供TitleBar控制項類型的 Microsoft 消費者介面自動化支援相關資訊。 標題列控制項代表視窗中的標題或標題列。

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

本主題包含下列各節。

一般樹狀結構

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

控制項檢視 內容檢視
  • 標題列
    • 功能表 (0 或 1 個)
    • 按鈕 (0 個以上)
 (不適用;標題列控制項沒有內容)

 

相關屬性

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

使用者介面自動化屬性 值 注意
UIA_AutomationIdPropertyId 請參閱備註。 此屬性的值在消費者介面自動化樹狀結構的原始檢視中，所有對等專案都必須是唯一的。
UIA_BoundingRectanglePropertyId 請參閱備註。 這個屬性所公開的值必須包含所有內含的控制項。
UIA_ClickablePointPropertyId 請參閱備註。 如果有週框即受支援。 如果周框內的每個點都無法點選，且元素會執行特製化點擊測試，請覆寫並提供可點選的點。
UIA_ControlTypePropertyId 標題列 此值與所有使用者介面架構的值相同。
UIA_IsContentElementPropertyId FALSE 標題列控制項永遠不會包含在消費者介面自動化樹的內容檢視中。
UIA_IsControlElementPropertyId true 標題列控制項一律包含在消費者介面自動化樹狀結構的控制項檢視中。
UIA_IsKeyboardFocusablePropertyId false 標題列控制項永遠不會有鍵盤焦點。
UIA_IsOffscreenPropertyId 相依 標題列控制項會根據畫面上是否可見，傳回值。
UIA_LabeledByPropertyId 請參閱備註。 標題列控制項通常沒有標籤。
UIA_LocalizedControlTypePropertyId 請參閱備註。 對應到標題列控制項類型的當地語系化字串。 預設值為 en-US 或英文 (美國) 的「標題列」。
UIA_NamePropertyId "" 標題列不是內容;其文字資訊會以父視窗的名稱公開。

 

必要的控制項模式

不需要 TitleBar控制項類型，才能支援任何控制項模式。 其功能是透過視窗控制項類型的視窗控制項模式公開。

必要的事件

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

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

 

概念

UI 自動化控制項類型概觀

UI 自動化概觀