RadScrollViewer
The only implementation of IScrollViewer and base class of all scrollable elements.
This class contains one element called Viewport. In addition to the ordinary property Size, Viewport has parameter called "extent size" which represents the real size of its content. Extent size could be bigger as well as smaller than the size of the scroll viewer.
There are two types of viewports: ordinary elements and elements that implement IRadScrollViewport. In the first case extent size is the size of the viewport itself. The scrolling is done on pixel basis and via painting offset of the viewport (it is called physical scrolling). In the second case the functions that are declared in IRadScrollViewport are called for getting extent size and performing the scroll operation (this is called logical scrolling).
If the viewport implementation is of type IRadScrollViewport it still can be physically scrolled by setting the property UsePhysicalScrolling to true.
Physical scrolling has one parameter that can be set - PixelsPerLineScroll which represents the small change value for the scrolling (i.e. the number of pixels for Line Up/Down/Left/Right). The large change (Page Up/Down/Left/Right) is the corresponding size of the viewable size of the viewport.
For more information about custom viewports and logical scrolling - see IRadScrollViewport.
Current scroll position can be get or set via the property Value. In addition scrolling can be performed by calling the methods that are implemented from IScrollViewer.
Definition
Namespace:Telerik.WinControls.UI
Assembly:Telerik.WinControls.UI.dll
Syntax:
public class RadScrollViewer : RadItem, INotifyPropertyChanged, ICustomTypeDescriptor, ISupportSystemSkin, IBindableComponent, IComponent, IDisposable, ISupportDrag, ISupportDrop, IShortcutProvider, IStylableElement, IStylableNode, IScrollViewerInheritance: objectDisposableObjectRadObjectRadElementVisualElementRadComponentElementRadItemRadScrollViewer...
Derived Classes:
Implements:
Inherited Members
Constructors
public RadScrollViewer()Properties
[Browsable(false)]
public bool CanHorizontalScroll { get; }[Browsable(false)]
public bool CanVerticalScroll { get; }[Browsable(false)]
public RadElement FillElement { get; }[Browsable(false)]
public bool ForceViewportHeight { get; set; }[Browsable(false)]
public bool ForceViewportWidth { get; set; }[Browsable(false)]
public RadScrollBarElement HorizontalScrollBar { get; }[Browsable(true)]
public ScrollState HorizontalScrollState { get; set; }[Browsable(true)]
public Point PixelsPerLineScroll { get; set; }public RadScrollLayoutPanel ScrollLayoutPanel { get; }[Browsable(true)]
public int ScrollThickness { get; set; }Gets or sets a value indicating whether the border is shown.
[Browsable(true)]
public bool ShowBorder { get; set; }Gets or sets a value indicating whether the fill is shown.
[Browsable(true)]
public bool ShowFill { get; set; }[Browsable(true)]
public bool UsePhysicalScrolling { get; set; }[Browsable(false)]
public RadScrollBarElement VerticalScrollBar { get; }[Browsable(true)]
public ScrollState VerticalScrollState { get; set; }[Browsable(false)]
public virtual RadElement Viewport { get; set; }Gets whether the scroll viewer uses a virtualized viewport
[Browsable(true)]
public virtual bool Virtualized { get; set; }Implements:
Methods
Called by the element when constructed. Allows inheritors to build the element tree.
protected override void CreateChildElements()Overrides:
Initializes the fields of this instance with their default values.
protected override void InitializeFields()Overrides:
Scrolls down within viewport by one logical unit.
public void LineDown()Implements:
Scrolls left within viewport by one logical unit.
public void LineLeft()Implements:
Scrolls right within viewport by one logical unit.
public void LineRight()Implements:
Scrolls up within viewport by one logical unit.
public void LineUp()Implements:
Measures the space required by the RadElement
Used by the layout system.
protected override SizeF MeasureOverride(SizeF availableSize)The size that is available to the RadElement. The available size can be infinity (to take the full size of the element)
Returns:The minimum size required by the element to be completely visible. Cannot be infinity.
Overrides:
In this method call to the Measure method of each child must be made.
Called when a property value has changed, handling item-specific property change logic including text, visual state, and animation properties.
protected override void OnPropertyChanged(RadPropertyChangedEventArgs e)The property changed event arguments.
Overrides:
protected virtual void OnScrollNeedsChanged(ScrollNeedsEventArgs args)protected virtual void OnScrollParametersChanged(RadPanelScrollParametersEventArgs args)Scrolls down within viewport by one page.
public void PageDown()Implements:
Scrolls left within viewport by one page.
public void PageLeft()Implements:
Scrolls right within viewport by one page.
public void PageRight()Implements:
Scrolls up within viewport by one page.
public void PageUp()Implements:
Scrolls vertically to the end of the content.
public void ScrollToBottom()Implements:
Scrolls both horizontally and vertically to the end of the content.
public void ScrollToEnd()Implements:
Scrolls both horizontally and vertically to the beginning of the content.
public void ScrollToHome()Implements:
Scrolls horizontally to the beginning of the content.
public void ScrollToLeftEnd()Implements:
Scrolls horizontally to the end of the content.
public void ScrollToRightEnd()Implements:
Scrolls vertically to the beginning of the content.
public void ScrollToTop()Implements:
Events
public event RadScrollPanelHandler Scrollpublic event ScrollNeedsHandler ScrollNeedsChangedpublic event RadPanelScrollParametersHandler ScrollParametersChanged