UI 自动化对 Pane 控件类型的支持

更新：2007 年 11 月

本主题介绍 UI 自动化对 Pane 控件类型的支持。在 UI 自动化中，控件类型是一组条件，控件必须满足这些条件才能使用 ControlTypeProperty 属性。这些条件包括 UI 自动化树结构的特定准则、UI 自动化属性值和控件模式。

Pane 控件类型用于代表框架或文档窗口中的对象。用户可以在窗格控件之间以及当前窗格的内容中导航，但不能在不同窗格中的项之间导航。因此，窗格控件表示低于窗口或文档、但高于单个控件的分组级别。根据上下文的不同，用户可通过按 Tab、F6 或 Ctrl+Tab 在窗格之间导航。

以下几节定义了 Pane 控件类型必需的 UI 自动化树结构、属性、控件模式和事件。UI 自动化的要求适用于所有列表控件，无论控件是 Windows Presentation Foundation (WPF)、Win32 还是 Windows 窗体。

本主题包括下列各节。

必需的 UI 自动化树结构

下表描述了与窗格控件有关的 UI 自动化树的控件视图和内容视图，以及每个视图中可包含的内容。有关 UI 自动化树的更多信息，请参见 UI 自动化树概述。

控件视图	内容视图
Pane	Pane

下表列出了值或定义与窗格控件密切相关的 UI 自动化属性。有关 UI 自动化属性的更多信息，请参见客户端的 UI 自动化属性。

UI 自动化属性	值	说明
AutomationIdProperty()	请参见“说明”。	此属性的值必须在应用程序中的所有控件中保持唯一。
BoundingRectangleProperty	请参见“说明”。	包含整个控件的最外面的矩形。
IsKeyboardFocusableProperty	请参见“说明”。	如果该控件可以接收键盘焦点，则它必须支持此属性。
NameProperty	请参见“说明”。	此属性的值必须始终为清晰、明确而有意义的标题。
ClickablePointProperty	请参见“说明”。	此属性公开窗格控件的一个可单击的点，单击该点可导致窗格获得焦点。
LabeledByProperty	请参见“说明”。	窗格控件通常没有静态标签。如果有静态文本标签，则应通过此属性公开标签。
ControlTypeProperty	Pane	此值对于所有 UI 框架均相同。
LocalizedControlTypeProperty	“窗格”	与 Pane 控件类型相对应的本地化字符串。
IsContentElementProperty	True	窗格控件始终包括在 UI 自动化树的内容视图中。
IsControlElementProperty	True	窗格控件始终包括在 UI 自动化树的控件视图中。
HelpTextProperty	""	窗格控件的帮助文本应解释框架的用途以及它如何与其他框架相关。如果从 NameProperty 的值中无法了解框架的用途和关系，则必须要有说明。”
AccessKeyProperty	请参见“说明”。	如果按特定组合键可使窗格获得焦点，则应通过此属性公开该信息。

下表列出了必须由所有窗格控件支持的 UI 自动化控件模式。有关控件模式的更多信息，请参见 UI 自动化控件模式概述。

控件模式/模式属性	支持/值	说明
ITransformProvider	视情况而定	如果可以在屏幕上对窗格控件进行移动、大小调整或旋转，则实现此控件模式。
IWindowProvider	从不	如果需要实现此控件模式，控件应基于 Window 控件类型。
IDockProvider	视情况而定	如果窗格控件可以停靠，则实现此控件模式。

下表列出了必须由所有窗格控件支持的 UI 自动化事件。有关事件的更多信息，请参见 UI 自动化事件概述。

UI 自动化事件	支持/值	说明
WindowClosedEvent	从不	无
WindowOpenedEvent	从不	无
AsyncContentLoadedEvent	必需	无
BoundingRectangleProperty property-changed 事件。	必需	无
IsOffscreenProperty property-changed 事件。	必需	无
IsEnabledProperty property-changed 事件。	必需	无
HorizontallyScrollableProperty property-changed 事件。	视情况而定	无
HorizontalScrollPercentProperty property-changed 事件。	视情况而定	无
HorizontalViewSizeProperty property-changed 事件。	视情况而定	无
VerticalScrollPercentProperty property-changed 事件。	视情况而定	无
VerticallyScrollableProperty property-changed 事件。	视情况而定	无
VerticalViewSizeProperty property-changed 事件。	视情况而定	无
WindowVisualStateProperty property-changed 事件。	从不	无
AutomationFocusChangedEvent	必需	无
StructureChangedEvent	必需	无