实现 UI 自动化 RangeValue 控件模式
备注
本文档适用于想要使用 System.Windows.Automation 命名空间中定义的托管 UI 自动化类的 .NET Framework 开发人员。 有关 UI 自动化的最新信息,请参阅 Windows 自动化 API:UI 自动化。
本主题介绍了实现 IRangeValueProvider的准则和约定,包括有关事件和属性的信息。 本主题的结尾列出了指向其他参考资料的链接。
RangeValuePattern 控件模式用于支持可被设置为范围内的某个值的控件。 有关实现此控件模式的控件示例,请参阅 Control Pattern Mapping for UI Automation Clients。
实现准则和约定
在实现 Range Value 控件模式时,请注意以下准则和约定:
控件允许基于区域设置或用户首选项来校准支持的属性。 这样的一个示例是温度计控件,它可被设置为以华氏或摄氏显示温度。
具有不明确范围值的控件(如进度栏或滑块)应对这些值进行规范化。
进度栏的示例,其中值为整数类型,最小和最大属性值分别被规范化为 0 和 100
IRangeValueProvider 必需的成员
必需的成员 | 成员类型 | 说明 |
---|---|---|
IsReadOnlyProperty | 属性 | 无 |
ValueProperty | 属性 | 无 |
LargeChangeProperty | 属性 | 无 |
SmallChangeProperty | 属性 | 无 |
MaximumProperty | 属性 | 无 |
MinimumProperty | 属性 | 无 |
SetValue | 方法 | 无 |
没有与此控件模式关联的事件。
例外
提供程序必须引发以下异常。
例外类型 | 条件 |
---|---|
ArgumentOutOfRangeException | 使用一个大于SetValue 或小于 MaximumProperty 的值调用 MinimumProperty。 |