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.v22.1.dll

NuGet Package: DevExpress.Win.Grid

Declaration

C#

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

VB.NET

<DefaultValue(DefaultBoolean.Default)>
<XtraSerializableProperty>
Public Property AllowMerge As DefaultBoolean

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
True	true. DefaultBoolean.True has a constant value of 0, while the standard true value corresponds to a value of 1. In Visual Basic, do not use implicit conversion of Boolean values to DefaultBoolean, and vice versa, as the conversion may produce incorrect results.
False	false. DefaultBoolean.False has a constant value of 1, while the standard false value corresponds to a value of 0. In Visual Basic, do not use implicit conversion of Boolean values to DefaultBoolean, and vice versa, as the conversion may produce incorrect results.
Default	The default behavior determined by the control’s logic.

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.