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

更新：2007 年 11 月

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

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

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

本主题包括下列各节。

必需的 UI 自动化树结构

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

Range Value 控件模式

控件视图	内容视图
Spinner 编辑控件（0 个或 1 个）按钮（2 个）	微调框

Selection 控件模式

控件视图	内容视图
Spinner 编辑控件（0 个或 1 个）按钮（2 个）列表项（2 个或更多）	微调框列表项（2 个或多个）

若要确保自动化测试工具可以区分控件视图子树中的两个按钮，请根据需要分配 SmallIncrement 或 SmallDecrementAutomationId。

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

UI 自动化属性	值	说明
AutomationIdProperty()	请参见“说明”。	此属性的值必须在应用程序中的所有控件中保持唯一。
BoundingRectangleProperty	请参见“说明”。	包含整个控件的最外面的矩形。
ClickablePointProperty	请参见“说明”。	该微调框控件的可单击点为控件的编辑部分提供焦点。
IsKeyboardFocusableProperty	请参见“说明”。	如果该控件可以接收键盘焦点，则它必须支持此属性。
NameProperty	请参见“说明”。	微调框控件通常从静态文本标签获取其名称。
LabeledByProperty	请参见“说明”。	微调框控件具有静态文本标签。
ControlTypeProperty	Spinner	此值对于所有的 UI 框架均相同。
LocalizedControlTypeProperty	“微调框”	与 Spinner 控件类型相对应的本地化字符串。
IsContentElementProperty	True	Spinner 控件必须总是为内容。
IsControlElementProperty	True	Spinner 控件必须总是为控件。

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

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

UI 自动化事件	支持	说明
InvalidatedEvent	视情况而定	无
BoundingRectangleProperty property-changed 事件。	必需	无
IsOffscreenProperty property-changed 事件。	必需	无
IsEnabledProperty property-changed 事件。	必需	无
ValueProperty property-changed 事件。	视情况而定	无
ValueProperty property-changed 事件。	视情况而定	无
AutomationFocusChangedEvent	必需	无
StructureChangedEvent	必需	无