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

注意注意

本文档的目标读者是欲使用 System.Windows.Automation 命名空间中定义的托管 UI Automation类的 .NET Framework 开发人员。有关 UI Automation的最新信息,请参见 Windows Automation API: UI Automation(Windows 自动化 API:UI 自动化)。

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

选项卡项控件用作选项卡控件内的控件,用于选择要显示在窗口中的特定页面。

以下几节定义了 TabItem 控件类型必需的 UI Automation树结构、属性、控件模式和事件。 UI Automation的要求适用于所有选项卡项控件,无论控件是 Windows Presentation Foundation (WPF)、Win32 还是 Windows Forms。

本主题包括下列各节。

  • 必需的 UI 自动化树结构
  • 必需的 UI 自动化属性
  • 必需的 UI 自动化控件模式
  • 必需的 UI 自动化事件
  • 相关主题

必需的 UI 自动化树结构

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

控件视图

内容视图

TabItem

  • Image(0 个或 1 个)

  • Text

  • Pane

    • 各种控件(0 个或更多)

TabItem

  • Pane

    • 各种控件(0 个或更多)

必需的 UI 自动化属性

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

UI Automation属性

注释

AutomationIdProperty

请参见“说明”。

此属性的值在应用程序的所有控件中都必须保持唯一。

BoundingRectangleProperty

请参见“说明”。

包含整个控件的最外面的矩形。

ClickablePointProperty

请参见“说明”。

选项卡项控件必须有一个使该项能够被选定的可单击的点。

IsKeyboardFocusableProperty

请参见“说明”。

如果该控件可以接收键盘焦点,则它必须支持此属性。

NameProperty

请参见“说明”。

选项卡项控件自行进行标记。

LabeledByProperty

Null

选项卡项控件没有静态文本标签。

ControlTypeProperty

TabItem

此值对于所有的 UI 框架均相同。

LocalizedControlTypeProperty

“选项卡项”

与此控件类型相对应的本地化字符串。

IsContentElementProperty

True

选项卡项控件必须总是为内容。

IsControlElementProperty

True

选项卡项控件必须总是为控件。

ControllerForProperty()

请参见“说明”。

此属性可用作指向关联的选项卡窗格的指针。 当它不能将窗格承载为选项卡项对象的子级时,这会很有用。

必需的 UI 自动化控件模式

下表列出了必须由选项卡项控件支持的 UI Automation控件模式。 有关控件模式的更多信息,请参见 UI 自动化控件模式概述

控件模式

支持

注释

ISelectionItemProvider

选项卡项控件必须支持 SelectionItemPattern。

IInvokeProvider

选项卡项控件从不支持 InvokePattern。

必需的 UI 自动化事件

下表列出了必须由所有选项卡项控件支持的 UI Automation事件。 有关事件的更多信息,请参见 UI 自动化事件概述

UI Automation事件

支持

注释

BoundingRectangleProperty property-changed 事件。

必需

IsOffscreenProperty property-changed 事件。

必需

IsEnabledProperty property-changed 事件。

必需

AutomationFocusChangedEvent

必需

ElementSelectedEvent

必需

ElementRemovedFromSelectionEvent

必需

StructureChangedEvent

必需

请参见

参考

TabItem

概念

UI 自动化控件类型概述

UI 自动化概述