![]() |
---|
本文档的目标读者是欲使用 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
|
Spinner |
Selection 控件模式
控件视图 |
内容视图 |
---|---|
Spinner
|
Spinner
|
若要确保自动化测试工具可以区分控件视图子树中的两个按钮,请根据需要分配 SmallIncrement 或 SmallDecrement AutomationId。 对于一些实现,关联的 Edit 控件可与 Spinner 控件对等。
必需的 UI 自动化属性
下表列出了值或定义与微调框控件密切相关的 UI Automation属性。 有关 UI Automation属性的更多信息,请参见 客户端的 UI 自动化属性。
UI Automation属性 |
值 |
注释 |
---|---|---|
请参见“说明”。 |
此属性的值在应用程序的所有控件中都必须保持唯一。 |
|
请参见“说明”。 |
包含整个控件的最外面的矩形。 |
|
请参见“说明”。 |
该微调框控件的可单击点为控件的编辑部分提供焦点。 |
|
请参见“说明”。 |
如果该控件可以接收键盘焦点,则它必须支持此属性。 |
|
请参见“说明”。 |
微调框控件通常从静态文本标签获取其名称。 |
|
请参见“说明”。 |
微调框控件具有静态文本标签。 |
|
Spinner |
此值对于所有的 UI 框架均相同。 |
|
“微调框” |
与 Spinner 控件类型相对应的本地化字符串。 |
|
True |
Spinner 控件必须总是为内容。 |
|
True |
Spinner 控件必须总是为控件。 |
必需的 UI 自动化控件模式和属性
下表列出了必须由微调框控件支持的 UI Automation控件模式。 有关控件模式的更多信息,请参见 UI 自动化控件模式概述。
控件模式/模式属性 |
支持/值 |
注释 |
---|---|---|
视情况而定 |
具有要选择的项列表的微调框控件必须支持此模式。 |
|
False |
微调框控件总是为单选容器。 |
|
视情况而定 |
跨数字范围的 Spinner 控件可以支持此模式。 |
|
视情况而定 |
跨一组离散选项和数字的 Spinner 控件可以支持此模式。 |
必需的 UI 自动化事件
下表列出了必须由所有微调框控件支持的 UI Automation事件。 有关事件的更多信息,请参见 UI 自动化事件概述。
UI Automation事件 |
支持 |
注释 |
---|---|---|
视情况而定 |
无 |
|
BoundingRectangleProperty property-changed 事件。 |
必需 |
无 |
IsOffscreenProperty property-changed 事件。 |
必需 |
无 |
IsEnabledProperty property-changed 事件。 |
必需 |
无 |
ValueProperty property-changed 事件。 |
视情况而定 |
无 |
ValueProperty property-changed 事件。 |
视情况而定 |
无 |
必需 |
无 |
|
必需 |
无 |