AllowMerging Property (C1FlexGrid)

Visual Basic
C#
C++/CLI

'Declaration
 
<C1DescriptionAttribute("Gets or sets how cells should be merged.")>
<BrowsableAttribute(True)>
<DefaultValueAttribute()>
<C1CategoryAttribute("Behavior")>
Public Property AllowMerging As AllowMergingEnum

'Usage
 
Dim instance As C1FlexGrid
Dim value As AllowMergingEnum
 
instance.AllowMerging = value
 
value = instance.AllowMerging

[C1Description("Gets or sets how cells should be merged.")]
[Browsable(true)]
[DefaultValue()]
[C1Category("Behavior")]
public AllowMergingEnum AllowMerging {get; set;}

[C1Description("Gets or sets how cells should be merged.")]
[Browsable(true)]
[DefaultValue()]
[C1Category("Behavior")]
public:
property AllowMergingEnum AllowMerging {
   AllowMergingEnum get();
   void set (    AllowMergingEnum value);
}

Merging cells allows you to display data in a clear, appealing way, because it highlights groups of identical information. It also gives you flexibility to build tables similar to the ones you can create in HTML or using Microsoft Word, both of which support merged cells.

To create tables with merged cells, set the AllowMerging property to a value other than AllowMergingEnum.None, and set the RowCol.AllowMerging property of individual rows and columns true for the rows and columns you wish to merge. After these properties are set, the grid will automatically merge adjacent cells that have the same contents.

Whenever the cell contents change, the grid updates the merging state.

The code below causes the grid to merge cells with the same data in column 1:

C#

flex.AllowMerging = AllowMergingEnum.Free;
flex.Cols[1].AllowMerging = true; // merge values in column 1

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

Reference

C1FlexGrid Class
C1FlexGrid Members