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

注意注意

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

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

Spinner 控件用于从项域或数字范围中进行选择。

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

本主题包括下列各节。

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

必需的 UI 自动化树结构

下表描述了在 Spinner 控件支持 Range Value、Value 和 Selection 控件模式时与其有关的 UI Automation树的控件视图和内容视图,还描述了每个视图中可包含的内容。 有关 UI Automation树的更多信息,请参见 UI 自动化树概述

Range Value 或 Value 控件模式

控件视图

内容视图

Spinner

  • Edit(0 个或 1 个)

  • Button(2 个)

Spinner

Selection 控件模式

控件视图

内容视图

Spinner

  • Edit(0 个或 1 个)

  • Button(2 个)

  • List Item(0 个或更多)

Spinner

  • ListItem(0 个或更多)

若要确保自动化测试工具可以区分控件视图子树中的两个按钮,请根据需要分配 SmallIncrement 或 SmallDecrement AutomationId。 对于一些实现,关联的 Edit 控件可与 Spinner 控件对等。

必需的 UI 自动化属性

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

UI Automation属性

注释

AutomationIdProperty

请参见“说明”。

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

BoundingRectangleProperty

请参见“说明”。

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

ClickablePointProperty

请参见“说明”。

该微调框控件的可单击点为控件的编辑部分提供焦点。

IsKeyboardFocusableProperty

请参见“说明”。

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

NameProperty

请参见“说明”。

微调框控件通常从静态文本标签获取其名称。

LabeledByProperty

请参见“说明”。

微调框控件具有静态文本标签。

ControlTypeProperty

Spinner

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

LocalizedControlTypeProperty

“微调框”

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

IsContentElementProperty

True

Spinner 控件必须总是为内容。

IsControlElementProperty

True

Spinner 控件必须总是为控件。

必需的 UI 自动化控件模式和属性

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

控件模式/模式属性

支持/值

注释

ISelectionProvider

视情况而定

具有要选择的项列表的微调框控件必须支持此模式。

CanSelectMultiple

False

微调框控件总是为单选容器。

IRangeValueProvider

视情况而定

跨数字范围的 Spinner 控件可以支持此模式。

IValueProvider

视情况而定

跨一组离散选项和数字的 Spinner 控件可以支持此模式。

必需的 UI 自动化事件

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

UI Automation事件

支持

注释

InvalidatedEvent

视情况而定

BoundingRectangleProperty property-changed 事件。

必需

IsOffscreenProperty property-changed 事件。

必需

IsEnabledProperty property-changed 事件。

必需

ValueProperty property-changed 事件。

视情况而定

ValueProperty property-changed 事件。

视情况而定

AutomationFocusChangedEvent

必需

StructureChangedEvent

必需

请参见

参考

Spinner

概念

UI 自动化控件类型概述

UI 自动化概述