GridOptionsView.AllowCellMerge Property
Gets or sets whether neighboring cells with identical values merge.
Namespace: DevExpress.XtraGrid.Views.Grid
Assembly: DevExpress.XtraGrid.v21.2.dll
NuGet Packages: DevExpress.Win.Design, DevExpress.Win.Grid
Declaration
[DefaultValue(false)]
[XtraSerializableProperty]
public virtual bool AllowCellMerge { get; set; }Property Value
| Type | Default | Description |
|---|---|---|
| Boolean | false | true, to allow neighboring cells with identical values to merge; otherwise, false. |
Property Paths
You can access this nested property as listed below:
| Object Type | Path to AllowCellMerge |
|---|---|
| GridView |
|
Remarks
The AllowCellMerge property controls the availability of the cell merge feature. If it is set to true this feature is enabled and neighboring cells with identical values may be merged.
When cell merging is enabled, you can still prevent cells in a specific column from being merged by setting the column’s OptionsColumn.AllowMerge property to DefaultBoolean.False.
Custom cell merging can also be implemented by handling the View’s GridView.CellMerge event.
When cell merging is enabled, specific features (such as cell editing, row multiple selection, etc.) aren’t available. See the Cells topic for more information.
An AdvBandedGridView View does not support the Cell Merging feature, because this View allows column cells to be arranged in several lines. Thus, cells that belong to a single column may not be neighbors. If it’s necessary to have bands and the Cell Merging feature, use the BandedGridView View instead.
Note
If the GridOptionsView.ShowPreview option is set to true, neighboring cells with identical values cannot be merged regardless of the AllowCellMerge property’s value.