TcxGridColumn.OnCompareRowValuesForCellMerging 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 OnCompareRowValuesForCellMerging: TcxGridColumnCompareRowValuesEvent read; write;

Remarks

When a column has its Options.CellMerging property set to True, the OnCompareRowValuesForCellMerging event (as with 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 ARow1 and ARow2, AProperties1 and AProperties2, AValue1 and AValue2 parameter pairs specify correspondingly the rows in which the cells whose values are being compared are displayed, editor-specific attributes and edit values for the first and second cells’ editors. The OnCompareRowValuesForCellMerging event is an extended version of the column’s OnCompareValuesForCellMerging event. It provides in addition the data rows in which the cells are displayed as additional parameters. You can use these values to perform additional comparisons of the cells’ values. The AAreEqual parameter gives the comparison’s result and initially is equal to the result of the OnCompareValuesForCellMerging event (if it is assigned). Otherwise, the initial value of the AAreEqual parameter indicates whether the displayed values of the cells are the same.