Version

Enabling Cell Merging

Topic Overview

Purpose

This topic explains, with code examples, how to enable Cell Merging feature of the WebHierarchicalDataGrid™ control on sorting and grouping behaviors. If you need details about the Cell Merging feature itself, refer to the Cell Merging Overview topic.

Required background

The following table lists the materials required as a prerequisite to understanding this topic.

Topic Purpose

This topic explains, with code examples, how to enable sorting for the users of the WebHierarchicalDataGrid .

This topic explains the Outlook GroupBy feature of the WebHierarchicalDataGrid and demonstrates, with code examples, how to enable it.

This topic provides an overview of the Cell Merging feature of the WebHierarchicalDataGrid .

Enabling Cell Merging

Overview

By default, Cell Merging is disabled. To enable it, you need to have the sorting behavior enabled and set the EnableCellMerging property to true .

For the child bands, you need to enable Cell Merging separately for each band. This is true for the child features, too – you need to specify the merge options individually for every band.

Property settings

The following table maps the desired Enable Cell Merging to property settings.

In order to: Use this property: And set it to:

Enable Cell Merging

true

Description

The following code snippets demonstrate how to enable Cell Merging server-side on the sorting and on the grouping behaviors of the grid.

Code example: enabling Cell Merging on sorting

In ASPX:

----<ig:WebHierarchicalDataGrid ID="WebHierarchicalDataGrid1" runat="server">
        <Behaviors>
             <ig:Sorting Enabled="true" EnableCellMerging="true">
              </ig:Sorting>
       </Behaviors>
</ig:WebHierarchicalDataGrid>
----

Code example: enabling Cell Merging on grouping

In ASPX:

----<ig:WebHierarchicalDataGrid ID="WebHierarchicalDataGrid1" runat="server">
            <GroupingSettings EnableColumnGrouping="True" GroupAreaVisibility="Visible" GroupAreaCssClass="GroupArea" EnableCellMerging="true" />
</ig:WebHierarchicalDataGrid>
----

Samples

The following samples provide additional information related to this topic.

Sample Purpose

This sample demonstrates the cell merging capabilities on sorting in WebHierarchicalDataGrid .

This sample demonstrates the cell merging capabilities on grouping in WebHierarchicalDataGrid .