New to Telerik UI for WinForms? Start a free 30-day trial

Implements the basic functionality for scrolling.

This class can be used both for horizontal and for vertical scrolling via its property ScrollType. In the Toolbox only the specialized children are put: RadHScrollBar and RadVScrollBar.

To adjust the value range of the scroll bar control, set the Minimum and Maximum properties. To adjust the distance the scroll thumb moves, set the SmallChange and LargeChange properties. To adjust the starting point of the scroll thumb, set the Value property when the control is initially displayed.

Definition

Namespace:Telerik.WinControls.UI

Assembly:Telerik.WinControls.UI.dll

Syntax:

C#
[ComVisible(false)]
public class RadScrollBarElement : RadItem, INotifyPropertyChanged, ICustomTypeDescriptor, ISupportSystemSkin, IBindableComponent, IComponent, IDisposable, ISupportDrag, ISupportDrop, IShortcutProvider, IStylableElement, IStylableNode

Inheritance: objectDisposableObjectRadObjectRadElementVisualElementRadComponentElementRadItemRadScrollBarElement...

Implements: IBindableComponentIComponentICustomTypeDescriptorIDisposableINotifyPropertyChangedIShortcutProviderIStylableElementIStylableNodeISupportDragISupportDropISupportSystemSkin...

Inherited Members RadItem.KeyDownEventRadItem.KeyPressEventRadItem.KeyUpEventRadItem.FocusCommandRadItem.ActionCommandRadItem.UseDefaultDisabledPaintPropertyRadItem.TextPropertyRadItem.TextOrientationPropertyRadItem.FlipTextPropertyRadItem.IsAddNewItemPropertyRadItem.ToolTipTextPropertyRadItem.EnableElementShadowPropertyRadItem.ShadowDepthPropertyRadItem.ShadowColorPropertyRadItem.IsPaintingRippleRadItem.EnableRippleAnimationPropertyRadItem.RippleAnimationColorPropertyRadItem.EnableFocusBorderPropertyRadItem.FocusBorderColorPropertyRadItem.FocusBorderWidthPropertyRadItem.EnableFocusBorderAnimationPropertyRadItem.EnableHighlightPropertyRadItem.HighlightColorPropertyRadItem.EnableBorderHighlightPropertyRadItem.BorderHighlightColorPropertyRadItem.BorderHighlightThicknessPropertyRadItem.VisualStatePropertyRadItem.SetOwnerCollection(RadItemOwnerCollection)RadItem.Select()RadItem.OnSelect()RadItem.Deselect()RadItem.OnDeselect()RadItem.DoKeyDown(KeyEventArgs)RadItem.DoKeyPress(KeyPressEventArgs)RadItem.DoKeyUp(KeyEventArgs)RadItem.OnKeyDown(KeyEventArgs)RadItem.OnKeyPress(KeyPressEventArgs)RadItem.OnKeyUp(KeyEventArgs)RadItem.RaiseBubbleEvent(RadElement, RoutedEventArgs)RadItem.OnPropertyChanging(RadPropertyChangingEventArgs)RadItem.OnEnabledChanged(RadPropertyChangedEventArgs)RadItem.OnTextChanging(TextChangingEventArgs)RadItem.OnTextChanged(EventArgs)RadItem.OnTextOrientationChanged(EventArgs)RadItem.OnFlipTextChanged(EventArgs)RadItem.PaintOverride(IGraphics, Rectangle, float, SizeF, bool)RadItem.OnMouseMove(MouseEventArgs)RadItem.StartRippleAnimation(MouseEventArgs)RadItem.UpdateFocusBorder(bool)RadItem.ContainsText()RadItem.ShouldSerializeProperty(PropertyDescriptor)RadItem.ProcessDialogKey(Keys)RadItem.ProcessCmdKey(ref Message, Keys)RadItem.RaiseKeyDown(KeyEventArgs)RadItem.RaiseKeyPress(KeyPressEventArgs)RadItem.RaiseKeyUp(KeyEventArgs)RadItem.ReplaceDefaultDescriptors(PropertyDescriptorCollection)RadItem.CallOnGesture(GestureEventArgs)RadItem.OnGesture(GestureEventArgs)RadItem.OnTwoFingerTapGesture(GestureEventArgs)RadItem.OnPressAndTapGesture(PressAndTapGestureEventArgs)RadItem.OnRotateGesture(RotateGestureEventArgs)RadItem.OnZoomGesture(ZoomGestureEventArgs)RadItem.CanDragCore(Point)RadItem.GetDragContextCore()RadItem.GetDragHintCore()RadItem.ProcessDragDrop(Point, ISupportDrag)RadItem.ProcessDragOver(Point, ISupportDrag)RadItem.ProcessDragEnter(Point, ISupportDrag)RadItem.ProcessDragLeave(Point, ISupportDrag)RadItem.UpdateOnShortcutsChanged()RadItem.CanHandleShortcut(ShortcutEventArgs)RadItem.IsOnActiveForm(Control, bool)RadItem.SetThemeValueOverride(RadProperty, object, string)RadItem.SetThemeValueOverride(RadProperty, object, string, string)RadItem.SetThemeValueOverride(RadProperty, object, string, Type)RadItem.ResetThemeValueOverride(RadProperty)RadItem.ResetThemeValueOverride(RadProperty, string)RadItem.ResetThemeValueOverrides()RadItem.GetAvailableVisualStates()RadItem.ShouldFallbackToDefaultTheme()RadItem.UseDefaultDisabledPaintRadItem.TextOrientationRadItem.FlipTextRadItem.CanHaveOwnStyleRadItem.TextRadItem.SelectableRadItem.DefaultAutoToolTipRadItem.ShouldHandleMouseInputRadItem.KeyTipRadItem.ParentItemRadItem.ShortcutsHandlerRadItem.EnableElementShadowRadItem.ShadowDepthRadItem.ShadowColorRadItem.EnableRippleAnimationRadItem.RippleAnimationColorRadItem.EnableFocusBorderRadItem.FocusBorderColorRadItem.FocusBorderWidthRadItem.EnableFocusBorderAnimationRadItem.EnableHighlightRadItem.HighlightColorRadItem.EnableBorderHighlightRadItem.BorderHighlightColorRadItem.BorderHighlightThicknessRadItem.MnemonicTextRadItem.ToolTipTextRadItem.ThemeRoleRadItem.VisualStateRadItem.StateManagerRadItem.AllowDragRadItem.AllowDropRadItem.ShortcutsRadItem.AccessibleDescriptionRadItem.AccessibleNameRadItem.AccessibleRoleRadItem.TextChangingRadItem.TextChangedRadItem.TextOrientationChangedRadItem.FlipTextChangedRadItem.QueryAccessibilityHelpRadItem.KeyDownRadItem.KeyPressRadItem.KeyUpRadItem.ZoomGestureRadItem.RotateGestureRadItem.PanGestureRadItem.TwoFingerTapGestureRadItem.PressAndTapGestureRadComponentElement.ToString()RadComponentElement.GetService(Type)RadComponentElement.CanRaiseEventsRadComponentElement.ContainerRadComponentElement.DesignModeRadComponentElement.SiteRadComponentElement.DataBindingsVisualElement.DefaultSizePropertyVisualElement.ForeColorPropertyVisualElement.BackColorPropertyVisualElement.FontPropertyVisualElement.SmoothingModePropertyVisualElement.OpacityPropertyVisualElement.CustomFontPropertyVisualElement.CustomFontSizePropertyVisualElement.CustomFontStylePropertyVisualElement.OnFontChanged(EventArgs)VisualElement.PaintElement(IGraphics, float, SizeF)VisualElement.PaintChildren(IGraphics, Rectangle, float, SizeF, bool)VisualElement.PrePaintElement(IGraphics)VisualElement.PostPaintElement(IGraphics)VisualElement.GetScaledFont(float)VisualElement.GetScaledFont(float, Font)VisualElement.DefaultSizeVisualElement.ForeColorVisualElement.BackColorVisualElement.FontVisualElement.CustomFontVisualElement.CustomFontSizeVisualElement.CustomFontStyleVisualElement.SmoothingModeVisualElement.OpacityVisualElement.FontChangedRadElement.BoundsPropertyRadElement.BorderThicknessPropertyRadElement.PaddingPropertyRadElement.MarginPropertyRadElement.AlignmentPropertyRadElement.AutoSizeModePropertyRadElement.FitToSizeModePropertyRadElement.MinSizePropertyRadElement.EnabledPropertyRadElement.CanFocusPropertyRadElement.IsItemFocusedPropertyRadElement.IsFocusedPropertyRadElement.IsMouseOverPropertyRadElement.IsMouseOverElementPropertyRadElement.IsMouseDownPropertyRadElement.ShouldPaintPropertyRadElement.VisibilityPropertyRadElement.NamePropertyRadElement.ClassPropertyRadElement.ClipDrawingPropertyRadElement.ShapePropertyRadElement.MouseClickedEventRadElement.MouseDoubleClickedEventRadElement.MouseDownEventRadElement.MouseUpEventRadElement.MouseWheelEventRadElement.ChildElementAddedEventRadElement.ParentChangedEventRadElement.BoundsChangedEventRadElement.VisibilityChangingEventRadElement.EnabledChangedEventRadElement.ControlChangedEventRadElement.BackgroundShapePropertyRadElement.BackgroundShapePaintModePropertyRadElement.ContainsFocusPropertyRadElement.ContainsMousePropertyRadElement.MaxSizePropertyRadElement.RightToLeftPropertyRadElement.AutoSizePropertyRadElement.ZIndexPropertyRadElement.AngleTransformPropertyRadElement.ScaleTransformPropertyRadElement.PositionOffsetPropertyRadElement.TagPropertyRadElement.StretchHorizontallyPropertyRadElement.StretchVerticallyPropertyRadElement.UseCompatibleTextRenderingPropertyRadElement.ClickModePropertyRadElement.styleVersionRadElement.paintSystemSkinRadElement.SetPropertyValueCommandRadElement.GetPropertyValueCommandRadElement.StylePropertyRadElement.CallCreateChildElements()RadElement.SuspendReferenceUpdate()RadElement.ResumeReferenceUpdate()RadElement.OnLoad(bool)RadElement.LoadCore()RadElement.OnUnload(ComponentThemableElementTree, bool)RadElement.UnloadCore(ComponentThemableElementTree)RadElement.OnUnloaded(ComponentThemableElementTree)RadElement.OnElementTreeChanged(ComponentThemableElementTree)RadElement.OnBeginDispose()RadElement.SetParent(RadElement)RadElement.OnParentChanged(RadElement)RadElement.UpdateReferences(ComponentThemableElementTree, bool, bool)RadElement.ResetLayout(bool)RadElement.HasInvisibleAncestor()RadElement.ResetLayoutCore()RadElement.InvalidateArrange()RadElement.InvalidateArrange(bool)RadElement.InvalidateMeasure()RadElement.InvalidateMeasure(bool)RadElement.UpdateLayout()RadElement.SuspendLayout()RadElement.SuspendLayout(bool)RadElement.ResumeLayout(bool)RadElement.ResumeLayout(bool, bool)RadElement.Arrange(RectangleF)RadElement.Measure(SizeF)RadElement.SetBounds(Rectangle)RadElement.SetBounds(int, int, int, int)RadElement.GetBoundingRectangle(Size)RadElement.GetBoundingRectangle(Rectangle)RadElement.GetDesiredSize(bool)RadElement.PointToScreen(Point)RadElement.PointFromScreen(Point)RadElement.PointToControl(Point)RadElement.PointFromControl(Point)RadElement.LocationToControl()RadElement.RectangleToScreen(Rectangle)RadElement.HitTest(Point)RadElement.OnRenderSizeChanged(SizeChangedInfo)RadElement.OnChildDesiredSizeChanged(RadElement)RadElement.OnLayoutPropertyChanged(RadPropertyChangedEventArgs)RadElement.ArrangeCore(RectangleF)RadElement.MeasureCore(SizeF)RadElement.ShouldArrangeChild(RadElement)RadElement.ShouldMeasureChild(RadElement)RadElement.MeasureChildren(SizeF)RadElement.GetArrangeRect(RectangleF)RadElement.CanExecuteLayoutOperation()RadElement.CalcLayoutOffset(PointF)RadElement.LockBounds()RadElement.UnlockBounds()RadElement.SetBoundsCore(Rectangle)RadElement.IsInValidState(bool)RadElement.Invalidate()RadElement.Invalidate(bool)RadElement.GetInvalidateBounds()RadElement.NotifyInvalidate(RadElement)RadElement.OnTransformationInvalidated()RadElement.PerformLayoutTransformation(ref RadMatrix)RadElement.PerformPaintTransformation(ref RadMatrix)RadElement.IsInGetAsBitmap()RadElement.PaintBackgroundShape(IGraphics)RadElement.PostPaintChildren(IGraphics, Rectangle, float, SizeF)RadElement.PaintChild(RadElement, IGraphics, Rectangle, float, SizeF, bool)RadElement.PaintShadow(RadElement, IGraphics)RadElement.PaintShadowCore(Graphics, Rectangle, RadItem)RadElement.GetShadowRect(ref Rectangle, int)RadElement.PaintFocusCues(IGraphics, Rectangle)RadElement.GetAsBitmap(IGraphics, Brush, float, SizeF)RadElement.GetAsTransformedBitmap(IGraphics, Brush, float, SizeF)RadElement.GetAsTransformedBitmap(Brush, float, SizeF)RadElement.GetAsTransformedBitmap(Rectangle, Brush, float, SizeF)RadElement.GetAsBitmapEx(Color, float, SizeF)RadElement.GetAsBitmapEx(Brush, float, SizeF)RadElement.GetAsBitmap(Brush, float, SizeF)RadElement.IsInVisibleClipBounds(Rectangle)RadElement.SetClipping(Graphics)RadElement.GetClipRect()RadElement.GetFocusRect()RadElement.GetCurrentShape()RadElement.GetPaintRectangle(float, float, SizeF)RadElement.GetPatchedRect(RectangleF, float, SizeF)RadElement.GetSystemSkinPaintBounds()RadElement.OnUseSystemSkinChanged(EventArgs)RadElement.ShouldPaintSystemSkin()RadElement.ComposeShouldPaintSystemSkin()RadElement.GetStylablePropertiesFilter()RadElement.ResetStyleSettings(bool)RadElement.ResetStyleSettings(bool, RadProperty)RadElement.ProcessBehaviors(RadPropertyChangedEventArgs)RadElement.AddBehavior(PropertyChangeBehavior)RadElement.GetBehaviors()RadElement.RemoveBehavior(PropertyChangeBehavior)RadElement.ClearBehaviors()RadElement.AddRangeBehavior(PropertyChangeBehaviorCollection)RadElement.SetThemeApplied(bool)RadElement.OnStyleChanged(RadPropertyChangedEventArgs)RadElement.UnapplyStyle()RadElement.RemoveRangeBehaviors(PropertyChangeBehaviorCollection)RadElement.RemoveBehaviors(PropertyChangeBehavior)RadElement.RemoveRangeRoutedEventBehaviors(RoutedEventBehaviorCollection)RadElement.GetThemeEffectiveType()RadElement.GetChildrenByType(Type)RadElement.GetChildrenByBaseType(Type)RadElement.FindAncestorByThemeEffectiveType(Type)RadElement.FindAncestor<T>()RadElement.IsAncestorOf(RadElement)RadElement.FindDescendant<T>()RadElement.FindDescendant(Predicate<RadElement>)RadElement.FindDescendant(Type)RadElement.EnumDescendants(TreeTraversalMode)RadElement.EnumDescendants(Predicate<RadElement>, TreeTraversalMode)RadElement.EnumDescendants(Filter, TreeTraversalMode)RadElement.GetDescendants(Predicate<RadElement>, TreeTraversalMode)RadElement.GetDescendants(Filter, TreeTraversalMode)RadElement.GetAncestors(Filter)RadElement.GetAncestors(Predicate<RadElement>)RadElement.RaiseRoutedEvent(RadElement, RoutedEventArgs)RadElement.RaiseTunnelEvent(RadElement, RoutedEventArgs)RadElement.OnTunnelEvent(RadElement, RoutedEventArgs)RadElement.OnBubbleEvent(RadElement, RoutedEventArgs)RadElement.IsEventInProcess(RaisedRoutedEvent)RadElement.RegisterRoutedEvent(string, Type)RadElement.GetRegisterRoutedEvent(string, Type)RadElement.GetRegisterRoutedEvent(string, string)RadElement.GetRegisterRoutedEvent(string)RadElement.OnChildrenChanged(RadElement, ItemsChangeOperation)RadElement.GetChildren(ChildrenListOptions)RadElement.SendToBack()RadElement.BringToFront()RadElement.IsChildOf(RadElement)RadElement.Focus()RadElement.Focus(bool)RadElement.SetFocusPropertySafe(bool)RadElement.KillFocus()RadElement.OnCLREventsRise(RoutedEventArgs)RadElement.OnMouseHover(EventArgs)RadElement.OnParentEnabledChanged(RadPropertyChangedEventArgs)RadElement.OnLostMouseCapture(MouseEventArgs)RadElement.OnClick(EventArgs)RadElement.OnDoubleClick(EventArgs)RadElement.OnMouseEnter(EventArgs)RadElement.PerformClick()RadElement.OnMouseWheel(MouseEventArgs)RadElement.DoMouseWheel(MouseEventArgs)RadElement.DoClick(EventArgs)RadElement.DoDoubleClick(EventArgs)RadElement.IsInputKey(InputKeyEventArgs)RadElement.MouseEventArgsFromControl(MouseEventArgs)RadElement.DoMouseDown(MouseEventArgs)RadElement.DoMouseUp(MouseEventArgs)RadElement.DoMouseMove(MouseEventArgs)RadElement.ShowScreenTip(ScreenTipNeededEventArgs)RadElement.HideScreenTip()RadElement.DoMouseHover(EventArgs)RadElement.OnShowScreenTip(ComponentInputBehavior)RadElement.RaiseClick(EventArgs)RadElement.RaiseDoubleClick(EventArgs)RadElement.RaiseMouseWheel(MouseEventArgs)RadElement.UpdateContainsFocus(bool)RadElement.DoMouseEnter(EventArgs)RadElement.DoMouseLeave(EventArgs)RadElement.GetValue(RadProperty)RadElement.AddStylePropertySetting(IPropertySetting)RadElement.SetValueCore(RadPropertyValue, object, object, ValueSource)RadElement.NotifyChildren(RadPropertyChangedEventArgs)RadElement.OnBoundsChanged(RadPropertyChangedEventArgs)RadElement.OnLocationChanged(RadPropertyChangedEventArgs)RadElement.OnDisplayPropertyChanged(RadPropertyChangedEventArgs)RadElement.CanRaisePropertyChangeNotifications(RadPropertyValue)RadElement.IsPropertyCancelable(RadPropertyMetadata)RadElement.OnParentPropertyChanged(RadPropertyChangedEventArgs)RadElement.PerformDispose(bool)RadElement.DisposeChildren()RadElement.GetStylableChildrenHierarchy()RadElement.GetStylableChildren()RadElement.GetClientRectangle(SizeF)RadElement.GetBorderThickness(BorderPrimitive)RadElement.DpiScaleChanged(SizeF)RadElement.ElementStateRadElement.DesiredSizeRadElement.IsLayoutSuspendedRadElement.BoundingRectangleRadElement.ControlBoundingRectangleRadElement.BypassLayoutPoliciesRadElement.IsArrangeValidRadElement.IsMeasureValidRadElement.TreeLevelRadElement.TransformRadElement.TotalTransformRadElement.ShouldPaintUsingParentShapeRadElement.UseSystemSkinRadElement.PropagateStyleToChildrenRadElement.ThemeEffectiveTypeRadElement.ElementTreeRadElement.ChildrenRadElement.ChildrenHierarchyRadElement.ParentRadElement.RoutedEventBehaviorsRadElement.LayoutableChildrenCountRadElement.ContainsFocusRadElement.NotifyParentOnMouseInputRadElement.IsAbleToRespondToMouseEventsRadElement.AutoSizeRadElement.BoundsRadElement.LocationRadElement.SizeRadElement.BorderThicknessRadElement.PaddingRadElement.MarginRadElement.AlignmentRadElement.AutoSizeModeRadElement.FitToSizeModeRadElement.EnabledRadElement.CanFocusRadElement.IsFocusedRadElement.IsMouseOverRadElement.IsMouseOverElementRadElement.IsMouseDownRadElement.InvalidateChildrenOnChildChangedRadElement.ShouldPaintRadElement.VisibilityRadElement.IsElementVisibleRadElement.NameRadElement.ClassRadElement.ClipDrawingRadElement.ShapeRadElement.MinSizeRadElement.MaxSizeRadElement.ZIndexRadElement.RightToLeftRadElement.UseCompatibleTextRenderingRadElement.BackgroundShapeRadElement.BackgroundShapePaintModeRadElement.ContainsMouseRadElement.CaptureRadElement.ScaleTransformRadElement.AngleTransformRadElement.PositionOffsetRadElement.SerializePropertiesRadElement.SerializeElementRadElement.SerializeChildrenRadElement.RenderingMaxFramerateRadElement.IsThemeAppliedRadElement.ShouldApplyThemeRadElement.UseCenteredAngleTransformRadElement.TagRadElement.StretchHorizontallyRadElement.StretchVerticallyRadElement.ClickModeRadElement.DoubleClickEnabledRadElement.CaptureOnMouseDownRadElement.IsItemHoveredRadElement.StyleRadElement.AutoToolTipRadElement.ScreenTipRadElement.AutoNumberKeyTipRadElement.DpiScaleFactorRadElement.LayoutUpdatedRadElement.MouseHoverRadElement.MouseMoveRadElement.MouseDownRadElement.MouseUpRadElement.ClickRadElement.DoubleClickRadElement.MouseEnterRadElement.MouseWheelRadElement.EnabledChangedRadElement.MouseLeaveRadElement.ChildrenChangedRadElement.LostMouseCaptureRadObject.BindingContextPropertyRadObject.RadTypeRadObject.ClearPropertyStore()RadObject.SuspendPropertyNotifications()RadObject.ResumePropertyNotifications()RadObject.GetPropertyValue(RadProperty)RadObject.SetDefaultValueOverride(RadProperty, object)RadObject.SetValue(RadProperty, object)RadObject.ResetValue(RadProperty)RadObject.ResetLocalValue(RadProperty)RadObject.ResetValue(RadProperty, ValueResetFlags)RadObject.UpdateValue(RadProperty)RadObject.GetValueSource(RadProperty)RadObject.GetRegisteredRadProperty(string)RadObject.UpdateValueCore(RadPropertyValue)RadObject.ResetValueCore(RadPropertyValue, ValueResetFlags)RadObject.GetDefaultValue(RadPropertyValue, object)RadObject.CoerceValue(RadPropertyValue, object)RadObject.ShouldSerializeProperty(RadProperty)RadObject.BindProperty(RadProperty, RadObject, RadProperty, PropertyBindingOptions)RadObject.UnbindProperty(RadProperty)RadObject.GetInheritedValue(RadProperty)RadObject.OnNotifyPropertyChanged(string)RadObject.OnNotifyPropertyChanged(PropertyChangedEventArgs)RadObject.OnShouldSerializeProperty(ShouldSerializePropertyEventArgs)RadObject.PropertyValuesRadObject.PropertyFilterRadObject.RadObjectTypeRadObject.BindingContextRadObject.PropertyChangedRadObject.RadPropertyChangedRadObject.RadPropertyChangingDisposableObject.GetBitState(long)DisposableObject.SetBitState(long, bool)DisposableObject.OnBitStateChanged(long, bool, bool)DisposableObject.Dispose()DisposableObject.Dispose(bool)DisposableObject.DisposeUnmanagedResources()DisposableObject.BitStateDisposableObject.EventsDisposableObject.IsDisposingDisposableObject.IsDisposedDisposableObject.DisposedDisposableObject.Disposing...

Constructors

C#
public RadScrollBarElement()

Fields

C#
public const ScrollType DefaultScrollType = Horizontal

Identifies the GradientAngleCorrection dependency property.

C#
public static readonly RadProperty GradientAngleCorrectionProperty

Gets or sets the default height for horizontal scroll bars.

C#
public static int HorizontalScrollBarHeight

Identifies the IsMouseOverScrollBar dependency property.

C#
public static readonly RadProperty IsMouseOverScrollBarProperty

Identifies the MinThumbLength dependency property.

C#
public static readonly RadProperty MinThumbLengthProperty

Identifies the Pressed dependency property.

C#
public static readonly RadProperty PressedProperty

Identifies the ScrollType dependency property.

C#
public static readonly RadProperty ScrollTypeProperty

Identifies the ThumbLengthProportion dependency property.

C#
public static readonly RadProperty ThumbLengthProportionProperty

Gets or sets the default width for vertical scroll bars.

C#
public static int VerticalScrollBarWidth

Properties

Gets the border primitive that renders the scroll bar's outline.

C#
public BorderPrimitive BorderElement { get; }

Indicates whether invalid values should be clamped or an exception should be thrown

C#
public bool ClampValue { get; set; }

Gets the fill primitive that renders the scroll bar's background.

C#
public FillPrimitive FillElement { get; }

Gets the first button element of this scrollbar

C#
public ScrollBarButton FirstButton { get; }

Controls the angle that the fill primitive will be rotated when switching from horizontal to vertical orientation

C#
public float GradientAngleCorrection { get; set; }

Gets or sets a value to be added to or subtracted from the Value property when the scroll thumb is moved a large distance.

C#
public int LargeChange { get; set; }
Property Value:

A numeric value. The default value is 10.

When the user presses the PAGE UP or PAGE DOWN key, clicks in the scroll bar track on either side of the scroll thumb, or calls one of the PageXXX() functions, the Value property changes according to the value set in the LargeChange property.

Gets or sets the upper limit of the scrollable range.

C#
public int Maximum { get; set; }
Property Value:

A numeric value. The default value is 100.

NOTE: The value of a scroll bar cannot reach its maximum value through user interaction at run time. The maximum value that can be reached is equal to the Maximum property value minus the LargeChange property value plus 1. The maximum value can only be reached programmatically.

Gets or sets the lower limit for the values of the scrollable range.

C#
public int Minimum { get; set; }
Property Value:

A numeric value. The default value is 0.

Gets or sets the minimum length of the scrolling thumb. See ThumbLength for more information about thumb length.

C#
public int MinThumbLength { get; set; }
Property Value:

An integer value that gives the minimum thumb length. It is taken into account no matter if the thumb length is calculated automatically or the thumb length is set explicitly. The thumb length could be smaller than MinThumbLength if there is no space in the scroll bar.

Gets or sets the scroll timer delay

C#
[Browsable(false)]
public int ScrollTimerDelay { get; set; }

Gets or sets the ScrollType - it could be horizontal or vertical.

C#
public ScrollType ScrollType { get; set; }

Gets the second button element of this scrollbar

C#
public ScrollBarButton SecondButton { get; }

Gets or sets the value to be added to or subtracted from the Value property when the scroll thumb is moved a small distance.

C#
public int SmallChange { get; set; }
Property Value:

A numeric value. The default value is 1.

When the user presses one of the arrow keys, clicks one of the scroll bar buttons or calls one of the LineXXX() functions, the Value property changes according to the value set in the SmallChange property.

Gets the thumb element of this scrollbar

C#
[Browsable(false)]
public ScrollBarThumb ThumbElement { get; }

Gets the length of the scrolling thumb. Thumb length is the thumb's height for vertical scroll bar and the thumb's width for horizontal scroll bar.

C#
public int ThumbLength { get; }

Gets or sets a value between 0.0 and 1.0 that indicates what part of the scrollable area can be occupied by the thumb. If the value is 0.0 then the thumb should be with length 0 but the property MinThumbLength will cause the thumb to be larger. If the value is 1.0 the thumb takes the whole area between the two scrolling buttons. Negative value means that the thumb length should be calculated automatically based on Minimum, Maximum and LargeChange values.

C#
public double ThumbLengthProportion { get; set; }

Gets or sets a numeric value that represents the current position of the scroll thumb on the scroll bar.

C#
public int Value { get; set; }
Property Value:

A numeric value that is within the Minimum and Maximum range. The default value is 0.

Methods

Arranges the track background, arrow buttons, and thumb according to the scrollbar orientation.

C#
protected override SizeF ArrangeOverride(SizeF finalSize)
Parameters:finalSizeSizeF

The final size allocated to the scrollbar.

Returns:

SizeF

The final size allocated to the scrollbar.

Overrides: RadElement.ArrangeOverride(SizeF)

Creates the track fill, arrow buttons, thumb, and border primitives that make up the scrollbar.

C#
protected override void CreateChildElements()

Overrides: RadElement.CreateChildElements()

Detaches and disposes the timers used for repeated scrolling.

C#
protected override void DisposeManagedResources()

Overrides: RadItem.DisposeManagedResources()

Retrieves the srolling parameters.

C#
public ScrollBarParameters GetParameters()
Returns:

ScrollBarParameters

Gets the Vista visual style element for this scroll bar.

C#
public override VisualStyleElement GetVistaVisualStyle()
Returns:

VisualStyleElement

The Vista visual style element.

Overrides: RadElement.GetVistaVisualStyle()

Gets the XP visual style element for this scroll bar.

C#
public override VisualStyleElement GetXPVisualStyle()
Returns:

VisualStyleElement

The XP visual style element.

Overrides: RadElement.GetXPVisualStyle()

Creates the delay and repeat timers used while a scrollbar track is held.

C#
protected override void InitializeFields()

Overrides: RadItem.InitializeFields()

Removes the thumb margin while system-skin rendering is active so it aligns with the native track.

C#
protected override void InitializeSystemSkinPaint()

Overrides: RadElement.InitializeSystemSkinPaint()

Measures the arrow buttons and thumb along the scrolling axis, including padding and border.

C#
protected override SizeF MeasureOverride(SizeF availableSize)
Parameters:availableSizeSizeF

The space available for measurement.

Returns:

SizeF

The combined desired size of the scrollbar elements.

Overrides: RadElement.MeasureOverride(SizeF)

Recalculates the fill-gradient correction after the element is loaded.

C#
protected override void OnLoaded()

Overrides: RadElement.OnLoaded()

Captures a left-button press on a track region and starts delayed repeat scrolling.

C#
protected override void OnMouseDown(MouseEventArgs e)
Parameters:eMouseEventArgs

The pressed button and pointer location.

Overrides: RadItem.OnMouseDown(MouseEventArgs)

Stops the repeat timer when the pointer leaves and the scrollbar does not hold capture.

C#
protected override void OnMouseLeave(EventArgs e)
Parameters:eEventArgs

The event data for the mouse-leave notification.

Overrides: RadItem.OnMouseLeave(EventArgs)

Stops repeated scrolling, releases mouse capture, and ends the current scroll interaction.

C#
protected override void OnMouseUp(MouseEventArgs e)
Parameters:eMouseEventArgs

The released button and pointer location.

Overrides: RadItem.OnMouseUp(MouseEventArgs)

Moves the thumb along the active axis in response to a pan and raises Scroll when the resulting value changes.

C#
protected override void OnPanGesture(PanGestureEventArgs args)
Parameters:argsPanGestureEventArgs

The gesture offset and handled state.

Overrides: RadItem.OnPanGesture(PanGestureEventArgs)

Updates orientation-dependent button directions, thumb sizing, hover state, or active scrolling when the corresponding properties change.

C#
protected override void OnPropertyChanged(RadPropertyChangedEventArgs e)
Parameters:eRadPropertyChangedEventArgs

The property change being processed.

Overrides: RadItem.OnPropertyChanged(RadPropertyChangedEventArgs)

Raises the Scroll event with the specified arguments.

C#
protected virtual void OnScroll(ScrollEventArgs args)
Parameters:argsScrollEventArgs

The scroll event data describing the type and amount of the scroll action.

Raises the ScrollParameterChanged event, unless the event is currently suppressed (for example while SetParameters(ScrollBarParameters) is applying multiple values at once).

C#
protected virtual void OnScrollParameterChanged()

Raises the ValueChanged event with an empty EventArgs.

C#
protected virtual void OnValueChanged()

Raises the ValueChanged event with a ScrollEventArgs describing the value transition and the scroll orientation determined by ScrollType.

C#
protected virtual void OnValueChanged(int oldValue, int newValue)
Parameters:oldValueint

The value before the change.

newValueint

The value after the change.

Selects orientation- and state-specific system visual-style parts for the track and delegates their rendering.

C#
protected override void PaintElementSkin(IGraphics graphics)
Parameters:graphicsIGraphics

The graphics context used to paint the track.

Overrides: RadElement.PaintElementSkin(IGraphics)

C#
protected virtual void PaintHorizontalVisualStylesElements()
C#
protected virtual void PaintVerticalVisualStyleElements()

Paints one native visual-style part when the target supports system-skin rendering.

C#
protected virtual void PaintVisualStyleElement(Graphics graphics, VisualStyleElement element, Rectangle bounds)
Parameters:graphicsGraphics

The graphics context for painting.

elementVisualStyleElement

The visual-style part to render.

boundsRectangle

The bounds in which to render the part.

Simulate scrolling with positioning the thumb on its first position. Unlike setting property Value this function fires scrolling events.

C#
public void PerformFirst()

Simulate scrolling - just like the top / left area according the thumb is pressed. Unlike setting property Value this function fires scrolling events.

C#
public void PerformLargeDecrement(int numSteps)
Parameters:numStepsint

Value is decremented with (numSteps * LargeChange)

Simulate scrolling - just like the bottom / right area according the thumb is pressed. Unlike setting property Value this function fires scrolling events.

C#
public void PerformLargeIncrement(int numSteps)
Parameters:numStepsint

Value is incremented with (numSteps * LargeChange)

Simulate scrolling with positioning the thumb on its last position. Unlike setting property Value this function fires scrolling events.

C#
public void PerformLast()

Scrolls just like the thumb is dragged at given position

C#
public void PerformScrollTo(Point position)
Parameters:positionPoint

Position of the thumb (in screen coordinates).

Simulate scrolling - just like the top / left button is pressed. Unlike setting property Value this function fires scrolling events.

C#
public void PerformSmallDecrement(int numSteps)
Parameters:numStepsint

Value is decremented with (numSteps * SmallChange)

Simulate scrolling - just like the bottom / right button is pressed. Unlike setting property Value this function fires scrolling events.

C#
public void PerformSmallIncrement(int numSteps)
Parameters:numStepsint

Value is incremented with (numSteps * SmallChange)

Sets the given scroll parameters.

C#
public void SetParameters(ScrollBarParameters parameters)
Parameters:parametersScrollBarParameters

Suppresses the custom fill and border primitives when the system skin paints the scrollbar.

C#
protected override bool ShouldPaintChild(RadElement element)
Parameters:elementRadElement

The child element being considered for painting.

Returns:

bool

false for the custom fill and border during system-skin painting; otherwise, the base decision.

Overrides: RadElement.ShouldPaintChild(RadElement)

Clears the temporary local thumb margin applied for system-skin rendering.

C#
protected override void UnitializeSystemSkinPaint()

Overrides: RadElement.UnitializeSystemSkinPaint()

Events

Occurs when the scroll thumb has been moved by either a mouse or keyboard action.

C#
public event ScrollEventHandler Scroll

Occurs when a property that affects the scrolling is changed. See ScrollBarParameters for more information on which properties affect the scrolling.

C#
public event EventHandler ScrollParameterChanged

Occurs when the Value property is changed, either by a Scroll event or programmatically.

C#
public event EventHandler ValueChanged