Skip to main content

OptionsColumn.AllowMerge Property

Gets or sets whether neighboring cells with identical values can be merged within the current column.

Namespace: DevExpress.XtraGrid.Columns

Assembly: DevExpress.XtraGrid.v23.2.dll

NuGet Packages: DevExpress.Win.Grid, DevExpress.Win.Navigation

Declaration

[DefaultValue(DefaultBoolean.Default)]
[XtraSerializableProperty]
public DefaultBoolean AllowMerge { get; set; }

Property Value

Type Default Description
DefaultBoolean Default

A DefaultBoolean enumeration value which specifies whether neighboring cells with identical values can be merged.

Available values:

Name Description Return Value
True

The value is true.

0

False

The value is false.

1

Default

The value is specified by a global option or a higher-level object.

2

Property Paths

You can access this nested property as listed below:

Object Type Path to AllowMerge
GridColumn
.OptionsColumn .AllowMerge

Remarks

Cell merging is enabled if the GridOptionsView.AllowCellMerge property is set to true.

By default, all the columns in a View have their AllowMerge properties set to DefaultBoolean.Default. In this case, cells will be only merged in sortable columns (the columns that use certain in-place editors). Cells will not be merged in the columns that use a PictureEdit, ImageEdit or MemoExEdit editor.

If the AllowMerge property is set to DefaultBoolean.True the grid will try to merge neighboring cells if they have matching values. Setting this property to DefaultBoolean.True is in effect for the columns that use the MemoExEdit in-place editor.

If the AllowMerge property is set to DefaultBoolean.False the cell merging feature is disabled for this column.

Refer to the Cells document for more information on the cell merging functionality.

See Also