Log In
Home
Support
Demos
Documentation
Blogs
Training
Webinars
[Expand]General Information
[Collapse]WinForms Controls
  Prerequisites
 [Expand]What's Installed
 [Expand]Build an Application
 [Collapse]Controls and Libraries
  [Expand]Forms and User Controls
  [Expand]Messages, Notifications and Dialogs
  [Expand]Editors and Simple Controls
  [Expand]Ribbon, Bars and Menu
  [Expand]Application UI Manager
  [Expand]Docking Library
  [Collapse]Data Grid
   [Expand]Getting Started
   [Expand]Binding to Data
   [Expand]Grid View
   [Collapse]View Technology
    [Expand]Banded Grid Views
    [Collapse]Card View
      Card View
      Card Settings
      Scrolling
      Card Layout
      Card Auto Width
    [Expand]Layout View
    [Expand]Tile View
    [Expand]WinExplorer View
     View Hierarchy
   [Expand]Grouping
   [Expand]Sorting
   [Expand]Summaries
   [Expand]Data Editing
   [Expand]Filtering and Locating Rows
   [Expand]Focus and Selection Handling
   [Expand]Processing Rows
   [Expand]Formatting Cell Values
   [Expand]Master-Detail Relationships
   [Expand]Asynchronous Image Load
   [Expand]Export and Printing
   [Expand]Appearance and Conditional Formatting
   [Expand]Batch Modifications
   [Expand]Hit Information
   [Expand]Hints
   [Expand]Popup Menus
   [Expand]Saving and Restoring Layouts
   [Expand]Visual Elements
   [Expand]Design-Time Features
   [Expand]Examples
   [Expand]End-User Capabilities
    Included Components
  [Expand]Vertical Grid
  [Expand]Pivot Grid
  [Expand]Tree List
  [Expand]Chart Control
  [Expand]Diagrams
  [Expand]Gauges
  [Expand]Map Control
  [Expand]Scheduler
  [Expand]Spreadsheet
  [Expand]Rich Text Editor
  [Expand]Spell Checker
  [Expand]Form Layout Managers
  [Expand]Navigation Controls
  [Expand]Printing-Exporting
  [Expand]PDF Viewer
   Reporting
  [Expand]Snap
  [Expand]TreeMap Control
 [Expand]Common Features
  Get More Help
 [Expand]API Reference
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Document Server
[Expand]Reporting
[Expand]Report Server
[Expand]Dashboard
[Expand]eXpressApp Framework
[Expand]CodeRush
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation

Scrolling

This document covers the following features: controlling end-users' ability to scroll Views, scrolling Views using code and ways to respond to end-user scrolling.

One way to scroll a View is to move the cell focus, however, this topic concerns scrolling techniques that don't involve cell focus changes. For information on moving focus between cells, refer to Focusing Cells and Moving Row Focus.

Expanded Scrolling Card Views

By default, a Card View displays a horizontal scroll bar and moving its thumb moves focus to the next/previous card. The scroll bar is displayed even when all cards are visible. If you do not wish to display this scroll bar, set the CardOptionsView.ShowHorzScrollBar option to false.

A Card View's height must be less than the height required to fit cards vertically when the CardView.VertScrollVisibility property value is ScrollVisibility.Auto or ScrollVisibility.Always. In this case, reducing the View's height results in displaying scroll buttons within cards. Such buttons enable end-users to scroll cards vertically. Note that if they are disabled (the CardView.VertScrollVisibility property value is ScrollVisibility.Never), the View's height cannot be less than the height required for a single card.

You can scroll Card Views using code using the CardView.TopLeftCardIndex property. Set this property to the desired card index to make that card the top-left visible within the View. Reading this property value enables you to determine the current View's scrolling offset. When this property value changes (the View is scrolled), the CardView.TopLeftCardChanged event is raised. Handle this event to process View scrolling.

Another member that supports the Card View scrolling feature is the CardView.FocusedCardTopFieldIndex property. This property enables you to scroll the focused card vertically (end-users can perform this action using scroll buttons).

The image below illustrates listed settings.

How would you rate this topic?​​​​​​​