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.v18.2.dll
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 |
|---|---|
| True | Corresponds to a Boolean value of true. |
| False | Corresponds to a Boolean value of false. |
| Default | The value is determined by the current object’s parent object setting (e.g., a control setting). |
Property Paths
You can access this nested property as listed below:
| Object Type | Path to AllowMerge |
|---|---|
| GridColumn |
|
| LayoutViewColumn |
|
| BandedGridColumn |
|
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.
Related GitHub Examples
The following code snippet (auto-collected from DevExpress Examples) contains a reference to the AllowMerge property.
Note
The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.