.gif "注意") 注意 |
|---|
本文档的目标读者是欲使用 System.Windows.Automation 命名空间中定义的托管 UI Automation类的 .NET Framework 开发人员。有关 UI Automation的最新信息，请参见 Windows Automation API: UI Automation（Windows 自动化 API：UI 自动化）。 |
本主题介绍 UI Automation对 TitleBar 控件类型的支持。 在 UI Automation中，控件类型是一组条件，控件必须满足这些条件才能使用 ControlTypeProperty 属性。 这些条件包括 UI Automation树结构的特定准则、UI Automation属性值和控件模式。
标题栏控件表示窗口中的标题或标题栏。
以下几节定义了 TitleBar 控件类型必需的 UI Automation树结构、属性、控件模式和事件。 UI Automation要求适用于所有标题栏控件，不论是 Windows Presentation Foundation (WPF)、Win32 还是 Windows Forms。
本主题包括下列各节。
- 必需的 UI 自动化树结构
- 必需的 UI 自动化属性
- 必需的 UI 自动化控件模式
- 必需的 UI 自动化事件
- 相关主题
必需的 UI 自动化树结构
下表描述了与标题栏控件有关的 UI Automation树的控件视图和内容视图，以及每个视图中可包含的内容。 有关 UI Automation树的更多信息，请参见 UI 自动化树概述。
控件视图 |
内容视图 |
|---|---|
TitleBar
|
不适用。 （标题栏控件不包含任何内容。） |
必需的 UI 自动化属性
下表列出了值或定义与 TitleBar 控件密切相关的 UI Automation属性。 有关 UI Automation 属性的更多信息，请参见 客户端的 UI 自动化属性。
UI Automation属性 |
值 |
注释 |
|---|---|---|
请参见“说明”。 |
此属性的值在应用程序的所有控件中都必须保持唯一。 |
|
请参见“说明”。 |
标题栏的边框必须包围其中所含的所有控件。 |
|
请参见“说明”。 |
有边框时支持。 如果边框中并非每个点都是可单击的，那么，在执行专用的命中测试时，请重写并提供一个可单击的点。 |
|
False |
标题栏绝对没有键盘焦点。 |
|
"" |
标题栏不是内容；其文字信息显示于父窗口上。 |
|
请参见“说明”。 |
标题栏控件通常没有标签。 |
|
TitleBar |
此值对于所有的 UI 框架均相同。 |
|
“标题栏” |
与 TitleBar 控件类型相对应的本地化字符串。 |
|
False |
标题栏控件绝不是内容。 |
|
True |
标题栏控件必须总是为控件。 |
|
视情况而定 |
此控件返回的值取决于标题栏控件在屏幕上是否可见。 |
|
"" |
不需要公开帮助文本。 |
|
"" |
标题栏绝对没有快捷键。 |
|
"" |
标题栏控件没有访问键。 |
必需的 UI 自动化控件模式
TitleBar 控件类型不是支持任意控件模式所必需的。 其功能是通过 Window 控件上的 Window 控件模式公开的。
必需的 UI 自动化事件
下表列出了所有标题栏控件必须支持的 UI Automation事件。 有关事件的更多信息，请参见 UI 自动化事件概述。
UI Automation事件 |
支持 |
注释 |
|---|---|---|
BoundingRectangleProperty property-changed 事件。 |
必需 |
无 |
IsOffscreenProperty property-changed 事件。 |
必需 |
无 |
IsEnabledProperty property-changed 事件。 |
从不 |
无 |
从不 |
无 |
|
必需 |
无 |