Share via


IXRRangeBase (Windows Embedded CE 6.0)

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 MinimumValueMaximum. 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

Inheritance Hierarchy

IXRDependencyObject

    IXRUIElement

        IXRFrameworkElement

            IXRControl

                IXRRangeBase

                    IXRScrollBar

                    IXRSlider

.NET Framework Equivalent

System.Windows.Controls.Primitives.RangeBase

Requirements

Header XamlRuntime.h
sysgen SYSGEN_XAML_RUNTIME
Windows Embedded CE Windows Embedded CE 6.0 R3

See Also

Reference

Classes for UI Element Management