IXRScrollBar (Windows Embedded CE 6.0)

Article
01/05/2012

1/6/2010

This class represents a control that provides a scrollbar that has a sliding thumb whose position corresponds to a value.

Syntax

class IXRScrollBar : public IXRRangeBase

Methods

Method	Description
IXRScrollBar::AddScrollEventHandler	Attaches a delegate to the Scroll event for this scrollbar. When the Scroll event is raised by this scrollbar, this delegate will be invoked.
IXRScrollBar::GetOrientation	Retrieves whether this scrollbar is displayed horizontally or vertically.
IXRScrollbar::GetViewportSize	Retrieves how much of the scrollable content is currently visible.
IXRScrollBar::RemoveScrollEventHandler	Removes a delegate from the Scroll event for this scrollbar.
IXRScrollBar::SetOrientation	Sets whether this scrollbar is displayed horizontally or vertically.
IXRScrollBar::SetViewportSize	Sets how much of the scrollable content is currently visible.

Remarks

The IXRScrollBar control consists of an IXRThumb control and two IXRRepeatButton controls. A user can increase and decrease the value of the IXRScrollBar control by pressing the IXRRepeatButton controls, or by moving the IXRThumb. The default range of values inherited from IXRRangeBase is from 0 to 10. The Value property inherited from IXRRangeBase represents the linear distance of the thumb between the endpoints of the IXRScrollbar. You can change the default range of values by calling IXRRangeBase::SetMinimum and IXRRangeBase::SetMaximum. To determine whether this IXRScrollBar is displayed horizontally or vertically, use IXRScrollBar::GetOrientation and IXRScrollBar::SetOrientation.

The scroll track in an IXRScrollBar is oriented so that values increase from top to bottom for a vertical scrollbar or from left to right for a horizontal scrollbar.

You can also define a scrollbar control in Microsoft Silverlight 2 XAML. For information about the differences between XAML in Silverlight for Windows Embedded and Silverlight 2, see Differences Between Silverlight for the Web and Silverlight for Windows Embedded. For more information about how to define this element in the source XAML for your application, see this Microsoft Web site.