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

更新：2007 年 11 月

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

标题栏控件表示窗口中的标题或标题栏。

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

本主题包括下列各节。

必需的 UI 自动化树结构

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

控件视图	内容视图
TitleBar Menu（1 个）按钮（0 个或多个）	TitleBar 控件不包含内容。

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

UI 自动化属性	值	说明
AutomationIdProperty	请参见“说明”。	此属性的值在应用程序中的所有控件中必须保持唯一。
BoundingRectangleProperty	请参见“说明”。	标题栏的边框必须包围其中所含的所有控件。
ClickablePointProperty	请参见“说明”。	有边框时支持。如果并非边框中的每个点都是可单击的，那么，当您执行专用的命中测试时，请重写并提供一个可单击的点。
IsKeyboardFocusableProperty	False	标题栏绝对没有键盘焦点。
NameProperty	""	标题栏不是内容；其文字信息显示于父窗口上。
LabeledByProperty	请参见“说明”。	标题栏控件通常没有标签。
ControlTypeProperty	TitleBar	此值对于所有的 UI 框架均相同。
LocalizedControlTypeProperty	“标题栏”	与 TitleBar 控件类型相对应的本地化字符串。
IsContentElementProperty	False	标题栏控件绝不是内容。
IsControlElementProperty	True	标题栏控件必须总是为控件。
IsOffscreenProperty	视情况而定	此控件返回的值取决于标题栏控件在屏幕上是否可见。
HelpTextProperty	""	不需要公开帮助文本。
AcceleratorKeyProperty	""	标题栏绝对没有快捷键。
AccessKeyProperty	""	标题栏控件没有访问键。

TitleBar 控件类型不是支持任意控件模式所必需的。其功能是通过 Window 控件上的 Window 控件模式公开的。

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

UI 自动化事件	支持	说明
BoundingRectangleProperty property-changed 事件。	必需	无
IsOffscreenProperty property-changed 事件。	必需	无
IsEnabledProperty property-changed 事件。	从不	无
AutomationFocusChangedEvent	从不	无
StructureChangedEvent	必需	无