窗格控件类型

项目
06/13/2023

本主题提供有关 Microsoft UI 自动化对窗格控件类型的支持的信息。

窗格控件类型适用于具有不同内容的潜在可滚动区域。它用于表示框架或文档窗口中的对象。用户可以在窗格控件之间和当前窗格的内容内导航。窗格控件表示低于窗口或文档但高于单个控件的分组级别。用户通过按 TAB、F6、或 CTRL + TAB 在窗格间导航，具体取决于上下文。

以下部分定义了窗格控件类型所需的UI 自动化树结构、属性、控件模式和事件。 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	TRUE	窗格控件始终包含在UI 自动化树的内容视图中。
UIA_IsControlElementPropertyId	TRUE	窗格控件始终包含在UI 自动化树的控件视图中。
UIA_IsKeyboardFocusablePropertyId	请参阅注释。	如果该控件可以接收键盘焦点，则它必须支持此属性。
UIA_LabeledByPropertyId	请参阅注释。	窗格控件通常不具有静态标签。如果没有静态文本标签，则它应通过此属性公开。
UIA_LocalizedControlTypePropertyId	请参阅注释。	对应于 Pane 控件类型的本地化字符串。 en-US 或英语 (美国) 的默认值为“pane”。
UIA_NamePropertyId	请参阅注释。	此属性的值必须始终为清晰、简洁而有意义的标题。

所需的控件模式

下表列出了窗格控件需要支持的UI 自动化控件模式。有关控件模式的详细信息，请参阅 UI Automation Control Patterns Overview。

控件模式	支持	说明
IDockProvider	依赖的对象	如果窗格控件可以停靠，则实现 Dock 控件模式。
IScrollProvider	依赖的对象	如果窗格控件可以滚动，则实现 Scroll 控件模式。
ITransformProvider	依赖的对象	如果窗格控件可以在屏幕上移动、调整大小或旋转，则实现转换控件模式。
IWindowProvider	从不	如果元素需要实现 Window 控件模式，则控件应基于 Window 控件类型。

必需事件

下表列出了窗格控件需要支持的UI 自动化事件。有关事件的详细信息，请参阅 F:System.Windows.Automation.AutomationElementIdentifiers.IsEnabledProperty。

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