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
   [Collapse]Grid View
    [Expand]Columns and Card Fields
    [Expand]Rows and Cards
    [Expand]Row, Column and Cell Access API
    [Collapse]Split Presentation
      Split Presentation Overview
      Tutorial: Split View Presentation
    [Expand]Cell Merging
    [Expand]Row Preview Sections
    [Expand]Scrolling
   [Expand]View Technology
   [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

Split Presentation Overview

The Split Presentation feature allows you to divide the grid horizontally or vertically into two view regions separated by a splitter. The regions present the same data and can be scrolled separately. Thus, when you split the grid vertically, you can edit the last grid row in the first region, while simultaneously viewing the first grid row in the second region.

When splitting the grid control horizontally, you can see the first and last columns in the split regions simultaneously.

Expanded Online Video

Learn how to split the grid in order to allow users to navigate through data in one part of the grid while maintaining the view of another part.

More Video

WinForms Grid - Split Containers

Expanded Creating Split Presentation

The Split Presentation is supported by the GridSplitContainer control with a GridControl placed inside it. When the Split Presentation is activated, two view regions are displayed separated by a splitter. The first region displays the original Grid Control, while the second region displays a copy of this Grid Control. This copy is dynamically created when the Split view is activated, and destroyed when the Split view is deactivated.

The Split Presentation can be activated only at runtime, by an end-user or via code.

Steps to create and activate the Split Presentation are described below.

  1. Create Grid Split Container

    If you want to create a new GridControl and enable the Split Presentation feature for it, you can add a GridSplitContainer directly from the Toolbox. The added GridSplitContainer will contain a new GridControl internally.

    For Grid Controls that existed in your old projects, you can add support for the Split Presentation feature at design time. Click the Add split container link, which is available using the Grid Control Tasks pane.

    This command invokes the GridControl.CreateSplitContainer method, which creates a GridSplitContainer and places the current Grid Control into this container. The created Split Container can now be accessed and customized using the Visual Studio Properties window.

    If you create a GridControl manually in code, and want to add support for the Split Presentation feature, we suggest that you create a GridSplitContainer object instead, as described in the example: How to: Create Split Presentation and Customize Embedded Grid Controls.

  2. Activate Split Presentation at Runtime

    If you run the application after you created a GridSplitContainer, the Split Presentation will not be immediately active. An end-user can activate the Split Presentation by clicking the Grid Control's Split command available using the control's context menu.

    Note

    The Split command's availability is specified by the GridOptionsMenu.ShowSplitItem option.

    At runtime, you can use the GridSplitContainer.ShowSplitView method to activate the Split Presentation.

    Once the Split Presentation is activated, the Grid Control is divided into two regions by creating another Grid Control in the second split region. Data in the two Grid Controls is synchronized. So, the changes made to the first Grid Control are automatically reflected by the second Grid Control and vice versa.

    The Split View can be removed by an end-user using the Remove Split command available on the grid's menu, or by calling the GridSplitContainer.HideSplitView method.

  3. Split Container's Settings

    There is a number of properties provided by the GridSplitContainer that affect the appearance and behavior of the Grid Control in a Split mode.

    The following events help you respond to the Split Presentation being activated and hidden: GridSplitContainer.SplitViewCreated, GridSplitContainer.SplitViewShown and GridSplitContainer.SplitViewHidden.

Expanded Split Presentation Limitations

The master-detail mode is not supported while the Split Presentation feature is in use.

Expanded See Also

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