IXRRangeBase (Windows Embedded CE 6.0)

Article
01/05/2012

1/6/2010

This class represents an element that has a value in a specific range, such as the IXRScrollBar and IXRSlider controls.

Syntax

class IXRRangeBase : public IXRControl

Methods

Method	Description
IXRRangeBase::AddMaximumChangedEventHandler	Attaches a delegate to the MaximumChanged event handler for this control. When the MaximumChanged event handler is raised by this control, this delegate will be invoked.
IXRRangeBase::AddMinimumChangedEventHandler	Attaches a delegate to the MinimumChanged event for this control. When the MinimumChanged event is raised by this control, this delegate will be invoked.
IXRRangeBase::AddValueChangedEventHandler	Attaches a delegate to the ValueChanged event for this control. When the ValueChanged event is raised by this control, this delegate will be invoked.
IXRRangeBase::GetLargeChange	Retrieves a value to be added to or subtracted from the Value of this IXRRangeBase control.
IXRRangeBase::GetMaximum	Retrieves the highest possible value of this IXRRangeBase control.
IXRRangeBase::GetMinimum	Retrieves the minimum possible value for this IXRRangeBase control.
IXRRangeBase::GetSmallChange	Retrieves a value to be added or subtracted from the Value of the IXRRangeBase control.
IXRRangeBase::GetValue	Retrieves the current setting of this IXRRangeBase control, which might be coerced.
IXRRangeBase::RemoveMaximumChangedEventHandler	Removes a delegate from the MaximumChanged event for this control.
IXRRangeBase::RemoveMinimumChangedEventHandler	Removes a delegate from the MinimumChanged event for this control.
IXRRangeBase::RemoveValueChangedEventHandler	Removes a delegate from the ValueChanged event for this control.
IXRRangeBase::SetLargeChange	Sets a value to be added to or subtracted from the Value of this IXRRangeBase control.
IXRRangeBase::SetMaximum	Sets the highest possible value of this IXRRangeBase control.
IXRRangeBase::SetMinimum	Sets the minimum possible value for this IXRRangeBase control.
IXRRangeBase::SetSmallChange	Sets a value to be added or subtracted from the Value of the IXRRangeBase control.
IXRRangeBase::SetValue	Sets the current setting of this IXRRangeBase control, which might be coerced.

Remarks

An IXRRangeBase control has a Value that can be set by calling IXRRangeBase::SetValue. It must be between the Minimum and Maximum properties, which you can retrieve by calling IXRRangeBase::GetMinimum and IXRRangeBase::GetMaximum. The IXRRangeBase control visually indicates its Value when it is rendered on-screen.

An IXRRangeBase control has a limited default style. If you want to augment the appearance of the control, you can create a new IXRControlTemplate.

The IXRRangeBase control uses property coercion to make sure that the Minimum, Maximum, and Value properties maintain the relationship of Minimum ≤ Value ≤ Maximum. Coercion affects the return value of each Get* method, but not the value of the associated field in the IXRRangeBase class. If the conditions that cause coercion are removed, the return value of each Get* method again reflects the true value of its associated field.

The following table shows an example sequence of setting values for IXRRangeBase and the resulting values for Minimum, Maximum, and Value at each step of the sequence.

Action	Minimum	Maximum	Value
Example original settings	Field = 15 Property = 15	Field = 100 Property = 100	Field = 30 Property = 30
Call IXRRangeBase::SetMinimum and pass in 200	Field = 200 Property = 200	Field = 100 Property = 200	Field = 30 Property = 200
Call IXRRangeBase::SetValue and pass in 45	Field = 200 Property = 200	Field = 100 Property = 200	Field = 45 Property = 200
Call IXRRangeBase::SetMinimum and pass in 0	Field = 0 Property = 0	Field = 100 Property = 100	Field = 45 Property = 45