General Information
.NET Subscription
Desktop
Web
Controls and Extensions
Mainteinance Mode
Enterprise and Analytic Tools
Quality Assurance and Productivity
Frameworks and Libraries
GridViewSettings.CustomCellMerge Property
Enables you to merge grid cells manually.
Namespace: DevExpress.Web.Mvc
Assembly: DevExpress.Web.Mvc5.v19.2.dll
Declaration
public ASPxGridViewCustomCellMergeEventHandler CustomCellMerge { get; set; }Public Property CustomCellMerge As ASPxGridViewCustomCellMergeEventHandlerProperty Value
| Type | Description |
|---|---|
| ASPxGridViewCustomCellMergeEventHandler | An ASPxGridViewCustomCellMergeEventHandler delegate method allowing you to implement custom processing. |
Remarks
When cell merging is allowed (by the ASPxGridViewBehaviorSettings.AllowCellMerge or GridViewDataColumnSettings.AllowCellMerge property), the grid automatically merges adjacent cells with the same values.
In this case, you can handle the CustomCellMerge event to implement cell merging manually.
Note
- The pairs of cells are processed randomly.
- The event handler won't process neighbor cells indexes one after another as this event can fire not only for adjacent pairs of cells in a column.
The event argument properties provide information about the processed column (ASPxGridViewCustomCellMergeEventArgs.Column), visible index of the rows that contain the processed cells (ASPxGridViewCustomCellMergeEventArgs.RowVisibleIndex1 and ASPxGridViewCustomCellMergeEventArgs.RowVisibleIndex2), and their values (ASPxGridViewCustomCellMergeEventArgs.Value1 and ASPxGridViewCustomCellMergeEventArgs.Value2).
To provide custom merging logic, set the ASPxGridViewCustomCellMergeEventArgs.Handled property to true and use the ASPxGridViewCustomCellMergeEventArgs.Merge property to specify if the currently processed cells should be merged. If the cells are merged, the resulting cell value is equal to ASPxGridViewCustomCellMergeEventArgs.Value1.