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

更新：2007 年 11 月

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

Slider 控件是一个包含多个按钮的复合控件，用户可以用鼠标单击其中的按钮来设置数值范围或者从一组项中进行选择。

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

本主题包括下列各节。

必需的 UI 自动化树结构

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

控件视图	内容视图
Slider 按钮（2 个或 4 个）滚动块（只有 1 个）列表项（2 个或更多）	Slider 列表项（2 个或更多）

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

UI 自动化属性	值	说明
AutomationIdProperty()	请参见“说明”。	此属性的值必须在应用程序中的所有控件中保持唯一。
BoundingRectangleProperty	请参见“说明”。	包含整个控件的最外面的矩形。
ClickablePointProperty	请参见“说明”	大部分滑块控件都必须引发 NoClickablePointException，因为滑块控件的整个边框都被子控件占用。
IsKeyboardFocusableProperty	请参见“说明”。	如果该控件可以接收键盘焦点，则它必须支持此属性。
NameProperty	请参见“说明”。	编辑控件的名称通常是从静态文本标签生成的。如果没有静态文本标签，则 Name 的属性值必须由应用程序开发人员分配。Name 属性决不应包含编辑控件的文本内容。
LabeledByProperty	请参见“说明”。	如果存在与该控件相关联的静态文本标签，则该属性必须公开对这个控件的引用。如果该文本控件是另一个控件的子组件，则它将不具有 LabeledBy 属性集。
ControlTypeProperty	Slider	此值对于所有 UI 框架均相同。
LocalizedControlTypeProperty	“滑块”	与 Edit 控件类型相对应的本地化字符串。
IsContentElementProperty	True	编辑控件始终包括在 UI 自动化树的内容视图中。
IsControlElementProperty	True	编辑控件始终包括在 UI 自动化树的控件视图中。

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

控件模式/控件模式属性	支持/值	说明
ISelectionProvider	视情况而定	依赖于内容是否为离散值
IRangeValueProvider	视情况而定	依赖于内容是否可以在数值范围内设置。

下表列出了必须由所有的滑块控件支持的 UI 自动化事件。

有关事件的更多信息，请参见 UI 自动化事件概述。

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