共用方式為


窗格控件類型

本主題提供 窗格 控件類型Microsoft使用者介面自動化支持的相關信息。

窗格 控件類型適用於可能具有不同內容的可捲動區域。 它用來表示框架或文件視窗中的物件。 用戶可以在窗格控件和目前窗格的內容之間巡覽。 窗格控件代表群組層級低於視窗或檔,但高於個別控件。 根據內容,使用者按下 TAB、F6 或 CTRL+TAB,在窗格之間巡覽。

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

本主題包含下列各節。

一般樹狀結構

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

控件檢視 內容檢視
  • 窗 格
  • 窗 格

 

窗格控件一律會出現在控件和內容檢視中。 如果物件僅用於可視化呈現,請勿在控件或內容檢視中將版面配置對象公開為窗格。

相關屬性

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

UI 自動化屬性 價值 筆記
UIA_AccessKeyPropertyId 請參閱附注。 如果特定按鍵組合將焦點提供給窗格,該資訊應該透過這個屬性公開。
UIA_AutomationIdPropertyId 請參閱附注。 在UI自動化樹狀結構的原始檢視中,此屬性的值在所有對等專案之間必須是唯一的。
UIA_BoundingRectanglePropertyId 請參閱附注。 包含整個控件的最外框。
UIA_ClickablePointPropertyId 請參閱附注。 這個屬性會公開窗格控件的可點選點,讓窗格在單擊時變成焦點。
UIA_ControlTypePropertyId 窗格
UIA_HelpTextPropertyId 請參閱附注。 窗格控件的說明文字應該說明框架的用途,以及它與其他框架的關係。 如果框架的用途和關聯性無法從 UIA_NamePropertyId 屬性的值中清楚,則需要描述。
UIA_IsContentElementPropertyId 窗格控件一律包含在UI自動化樹狀結構的內容檢視中。
UIA_IsControlElementPropertyId 窗格控件一律包含在UI自動化樹狀結構的控件檢視中。
UIA_IsKeyboardFocusablePropertyId 請參閱附注。 如果控件可以接收鍵盤焦點,它必須支援這個屬性。
UIA_LabeledByPropertyId 請參閱附注。 窗格控件通常沒有靜態標籤。 如果有靜態文字標籤,則應該透過這個屬性公開它。
UIA_LocalizedControlTypePropertyId 請參閱附注。 對應至 窗格 控制件類型的當地語系化字串。 預設值為 en-US 或英文 (美國) 的 「pane」。
UIA_NamePropertyId 請參閱附注。 此屬性的值一律必須是清楚、簡潔且有意義的標題。

 

必要的控制件模式

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

控制件模式 支援 筆記
IDockProvider 取決於 如果窗格控件可以停駐,請實作 Dock 控件模式。
IScrollProvider 取決於 如果窗格控件可以捲動,請實作 捲動 控件模式。
ITransformProvider 取決於 如果窗格控件可以在螢幕上移動、重設大小或旋轉,則實作 轉換 控件模式。
IWindowProvider 從不 如果專案需要實作 Window 控件模式,控件應該以 Window 控件類型為基礎。

 

必要事件

下表列出需要窗格控件才能支援的UI自動化事件。 如需事件的詳細資訊,請參閱 UI 自動化事件概觀

UI 自動化事件 筆記
UIA_AsyncContentLoadedEventId
UIA_AutomationFocusChangedEventId
UIA_BoundingRectanglePropertyId 屬性變更事件。
UIA_IsOffscreenPropertyId 屬性變更事件。 如果控件支援 IsOffscreen 屬性,它就必須支援這個事件。
UIA_ScrollHorizontallyScrollablePropertyId 屬性變更事件。 如果控件支援 Scroll 控件模式,則必須支援此事件。
UIA_ScrollHorizontalScrollPercentPropertyId 屬性變更事件。 如果控件支援 Scroll 控件模式,則必須支援此事件。
UIA_ScrollHorizontalViewSizePropertyId 屬性變更事件。 如果控件支援 Scroll 控件模式,則必須支援此事件。
UIA_ScrollVerticallyScrollablePropertyId 屬性變更事件。 如果控件支援 Scroll 控件模式,則必須支援此事件。
UIA_ScrollVerticalScrollPercentPropertyId 屬性變更事件。 如果控件支援 Scroll 控件模式,則必須支援此事件。
UIA_ScrollVerticalViewSizePropertyId 屬性變更事件。 如果控件支援 Scroll 控件模式,則必須支援此事件。
UIA_StructureChangedEventId

 

窗格控件類型範例

下圖說明實作 Pane 控件類型的控制件。

顯示窗格控件範例的螢幕快照 螢幕快照

UI 自動化樹狀結構 — 控件檢視 UI 自動化樹狀結構 — 內容檢視
  • 窗 格
    • 樹狀結構(捲動模式)
      • TreeItem
      • ...
  • 窗 格
    • 編輯 (捲動模式)
  • 窗 格
    • 樹狀結構(捲動模式)
      • TreeItem
      • ...
    • 窗 格
      • 編輯 (捲動模式)

 

概念

UI 自動化控制項類型概觀

UI 自動化概觀