Implementing the UI Automation RangeValue Control Pattern
This topic introduces guidelines and conventions for implementing IRangeValueProvider, including information about properties and methods. Links to additional references are listed at the end of the topic.
The RangeValue control pattern is used to support controls that can be set to a value within a range. For examples of controls that implement this control pattern, see Control Pattern Mapping for UI Automation Clients.
This topic contains the following sections.
- Implementation Guidelines and Conventions
- Required Members for IRangeValueProvider
- Related Topics
Implementation Guidelines and Conventions
When implementing the RangeValue control pattern, note the following guidelines and conventions:
- Controls allow recalibration of their supported properties based upon locale or user preference. An example of this is a thermometer control that can be set to display the temperature in Fahrenheit or Celsius.
- Controls that have ambiguous range values, such as progress bars or sliders, should have those values normalized.
Required Members for IRangeValueProvider
The following properties and methods are required for implementing the IRangeValueProvider interface.
| Required members | Member type | Notes |
|---|---|---|
| IRangeValueProvider::IsReadOnly | Property | None |
| IRangeValueProvider::Value | Property | None |
| IRangeValueProvider::LargeChange | Property | None |
| IRangeValueProvider::SmallChange | Property | None |
| IRangeValueProvider::Maximum | Property | None |
| IRangeValueProvider::Minimum | Property | None |
| IRangeValueProvider::SetValue | Method | None |
This control pattern has no associated events.