窗格控制項類型

發行項
06/13/2023

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

窗格控制項類型適用于可能具有不同內容的可捲動區域。它用來代表框架或文件視窗中的物件。使用者可以在窗格控制項與目前窗格的內容之間巡覽。窗格控制項代表低於視窗或檔的群組層級，但高於個別控制項。使用者在窗格之間巡覽的方式是依照內容而定，可按下 TAB、F6 或 CTRL+TAB 鍵。

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

本主題包含下列各節。

一般樹狀結構
相關屬性
必要的控制項模式
必要的事件
窗格控制項類型範例
相關主題

一般樹狀結構

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

控制項檢視	內容檢視
窗格	窗格

窗格控制項一律會出現在控制項和內容檢視中。如果物件僅用於視覺化呈現，請勿將版面設定物件公開為控制項或內容檢視中的窗格。

相關屬性

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

使用者介面自動化屬性	值	注意
UIA_AccessKeyPropertyId	請參閱備註。	如果特定按鍵組合將焦點提供給窗格，該資訊應該透過這個屬性公開。
UIA_AutomationIdPropertyId	請參閱備註。	此屬性的值在消費者介面自動化樹狀結構的原始檢視中，所有對等專案都必須是唯一的。
UIA_BoundingRectanglePropertyId	請參閱備註。	包含整個控制項的最外層矩形。
UIA_ClickablePointPropertyId	請參閱備註。	這個屬性會公開窗格控制項之可點選的點，當按一下該點時，窗格就會取得焦點。
UIA_ControlTypePropertyId	窗格
UIA_HelpTextPropertyId	請參閱備註。	窗格控制項的解說文字應該說明框架的用途，以及它與其他畫面格的關聯性。如果框架的用途和關聯性無法從 UIA_NamePropertyId 屬性的值清楚，則需要描述。
UIA_IsContentElementPropertyId	true	窗格控制項一律包含在消費者介面自動化樹狀結構的內容檢視中。
UIA_IsControlElementPropertyId	true	窗格控制項一律包含在消費者介面自動化樹狀結構的控制項檢視中。
UIA_IsKeyboardFocusablePropertyId	請參閱備註。	如果控制項可接收鍵盤焦點，就必定支援此屬性。
UIA_LabeledByPropertyId	請參閱備註。	窗格控制項通常沒有靜態標籤。如果有靜態文字標籤，則標籤應透過這個屬性公開。
UIA_LocalizedControlTypePropertyId	請參閱備註。	對應至 Pane 控制項類型的當地語系化字串。 en-US 或英文 (美國) 的預設值為「pane」。
UIA_NamePropertyId	請參閱備註。	這個屬性的值必須是清楚、精確且有意義的標題。

必要的控制項模式

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

控制項模式	支援	備註
IDockProvider	相依	如果窗格控制項可以停駐，請實作 Dock 控制項模式。
IScrollProvider	相依	如果窗格控制項可以捲動，請實作卷動控制項模式。
ITransformProvider	相依	如果窗格控制項可以在螢幕上移動、調整大小或旋轉，請實作轉換控制項模式。
IWindowProvider	永不	如果元素需要實作 Window 控制項模式，控制項應該以 Window 控制項類型為基礎。

必要的事件

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

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