TcxGridColumn.OnCompareValuesForCellMerging Event

Occurs when the values of two sequential cells in the column are compared to determine if these cells can be merged into a single cell.

Declaration

property OnCompareValuesForCellMerging: TcxGridColumnCompareValuesEvent read; write;

Remarks

When a column has its Options.CellMerging property set to True, the OnCompareValuesForCellMerging event occurs every time the values of two sequential cells are compared to determine if they are equal and thus the corresponding cells can be merged and displayed as a single cell.

The Sender parameter specifies the column whose cells are being compared. The AProperties1 and AProperties2, AValue1 and AValue2 parameter pairs specify editor-specific attributes and edit values for the first and second cells’ editors, correspondingly. You can use these values to perform additional comparisons of the cells’ values. The AAreEqual parameter gives the comparison’s result and initially indicates whether the displayed values of these cells are the same.

Note

The column’s OnCompareRowValuesForCellMerging event is an extended version of the OnCompareValuesForCellMerging event, which provides the data rows in which the cells are displayed as additional parameters.