实现 UI 自动化 RangeValue 控件模式

备注

本文档适用于想要使用 System.Windows.Automation 命名空间中定义的托管 UI 自动化类的 .NET Framework 开发人员。 有关 UI 自动化的最新信息,请参阅 Windows 自动化 API:UI 自动化

本主题介绍了实现 IRangeValueProvider的准则和约定,包括有关事件和属性的信息。 本主题的结尾列出了指向其他参考资料的链接。

RangeValuePattern 控件模式用于支持可被设置为范围内的某个值的控件。 有关实现此控件模式的控件示例,请参阅 Control Pattern Mapping for UI Automation Clients

实现准则和约定

在实现 Range Value 控件模式时,请注意以下准则和约定:

  • 控件允许基于区域设置或用户首选项来校准支持的属性。 这样的一个示例是温度计控件,它可被设置为以华氏或摄氏显示温度。

  • 具有不明确范围值的控件(如进度栏或滑块)应对这些值进行规范化。

Progress bar.进度栏的示例,其中值为整数类型,最小和最大属性值分别被规范化为 0 和 100

IRangeValueProvider 必需的成员

必需的成员 成员类型 说明
IsReadOnlyProperty 属性
ValueProperty 属性
LargeChangeProperty 属性
SmallChangeProperty 属性
MaximumProperty 属性
MinimumProperty 属性
SetValue 方法

没有与此控件模式关联的事件。

例外

提供程序必须引发以下异常。

例外类型 条件
ArgumentOutOfRangeException 使用一个大于SetValue 或小于 MaximumProperty 的值调用 MinimumProperty

请参阅