.gif "注意") 注意 |
|---|
本文档的目标读者是欲使用 System.Windows.Automation 命名空间中定义的托管 UI Automation类的 .NET Framework 开发人员。有关 UI Automation的最新信息，请参见 Windows Automation API: UI Automation（Windows 自动化 API：UI 自动化）。 |
本主题介绍 UI Automation对 Tab 控件类型的支持。 在 UI Automation中，控件类型是一组条件，控件必须满足这些条件才能使用 ControlTypeProperty 属性。 这些条件包括 UI Automation树结构的特定准则、UI Automation属性值和 UI Automation控件模式。
选项卡控件类似于笔记本中的分隔卡或档案柜中的标签。 通过使用选项卡控件，应用程序可以为窗口或对话框的相同区域定义多个页。
以下几节定义了 Tab 控件类型必需的 UI Automation树结构、属性、控件模式和事件。 UI Automation 的要求适用于所有选项卡控件，无论控件是 Windows Presentation Foundation (WPF)、Win32 还是 Windows Forms。
本主题包括下列各节。
- 必需的 UI 自动化树结构
- 必需的 UI 自动化属性
- 必需的 UI 自动化控件模式和属性
- 必需的 UI 自动化事件
- 相关主题
必需的 UI 自动化树结构
下表描述了与选项卡控件有关的 UI Automation树的控件视图和内容视图，以及每个视图中可包含的内容。 有关 UI Automation树的更多信息，请参见 UI 自动化树概述。
控件视图 |
内容视图 |
|---|---|
Tab
|
Tab
|
选项卡控件具有基于 TabItem 控件类型的子 UI Automation元素。 在对选项卡项进行分组（如在 Microsoft Office 2007 应用程序中）时，Tab 控件类型也可以承载用于分组选项卡项的 Groups 控件类型，如下面的树结构所示。
控件视图 |
内容视图 |
|---|---|
Tab
|
Tab
|
必需的 UI 自动化属性
下表列出了值或定义与 Tab 控件类型密切相关的 UI Automation属性。 有关 UI Automation属性的更多信息，请参见 客户端的 UI 自动化属性。
UI Automation属性 |
值 |
注释 |
|---|---|---|
请参见“说明”。 |
此属性的值在应用程序的所有控件中都必须保持唯一。 |
|
请参见“说明”。 |
包含整个控件的最外面的矩形。 |
|
请参见“说明”。 |
如果该控件可以接收键盘焦点，则它必须支持此属性。 |
|
请参见“说明”。 |
选项卡控件几乎不需要 Name 属性。 |
|
否 |
选项卡控件没有可单击的点。 |
|
请参见“说明”。 |
选项卡控件通常具有通过此属性公开的静态文本标签。 |
|
Tab |
此值对于所有的 UI 框架均相同。 |
|
“选项卡” |
与 Tab 控件类型相对应的本地化字符串。 |
|
True |
Tab 控件类型必须可以接收键盘焦点。 通常，UI Automation 客户端将在选项卡控件上调用 SetFocus，它的一个项会将键盘焦点转交到选项卡控件。 某些选项卡容器可以接受焦点，但不会将焦点设置为它的一个项。 |
|
True |
选项卡控件始终包括在 UI Automation树的内容视图中。 |
|
True |
选项卡控件始终包括在 UI Automation树的控件视图中。 |
|
请参见“说明”。 |
选项卡控件必须始终表明是水平放置还是垂直放置。 |
必需的 UI 自动化控件模式和属性
下表列出了必须由所有选项卡控件支持的 UI Automation 控件模式。 有关控件模式的更多信息，请参见 UI 自动化控件模式概述。
控件模式/模式属性 |
支持/值 |
注释 |
|---|---|---|
是 |
所有选项卡控件都必须支持 Selection 模式。 |
|
True |
选项卡控件始终要求进行选择。 |
|
False |
选项卡控件总是为单选容器。 |
|
视情况而定 |
在选项卡控件中必须支持 Scroll 模式，选项卡控件应该具有允许滚动一组选项卡项的小部件。 |
必需的 UI 自动化事件
下表列出了必须由所有选项卡控件支持的 UI Automation 事件。 有关事件的更多信息，请参见 UI 自动化事件概述。
UI Automation事件 |
支持 |
注释 |
|---|---|---|
BoundingRectangleProperty property-changed 事件。 |
必需 |
无 |
IsOffscreenProperty property-changed 事件。 |
必需 |
无 |
IsEnabledProperty property-changed 事件。 |
必需 |
无 |
HorizontallyScrollableProperty property-changed 事件。 |
视情况而定 |
无 |
HorizontalScrollPercentProperty property-changed 事件。 |
视情况而定 |
无 |
HorizontallyScrollableProperty property-changed 事件。 |
视情况而定 |
无 |
HorizontalViewSizeProperty property-changed 事件。 |
视情况而定 |
无 |
VerticalScrollPercentProperty property-changed 事件。 |
视情况而定 |
无 |
VerticalViewSizeProperty property-changed 事件。 |
视情况而定 |
无 |
必需 |
无 |
|
必需 |
无 |