<< Return to Main Index

< Return to Class Index

CGXGridCore::DelayMergeCells

void DelayMergeCells(const CGXRange& range, ROWCOL nMaxRow = GX_INVALID, ROWCOL nMaxCol = GX_INVALID);

range

Specifies the range of cells where floating cells shall be recalculated.

nMaxCol

You will normally not have to change this parameter. If you specify nMaxCol not equal to GX_INVALID, DelayMergeCells will loop through all delayed ranges and check if any range is going beyond column nMaxCol. If yes, the range will be cut at nMaxCol. Objective Grid specifies this parameter when columns have been removed.

nMaxRow

You will normally not have to change this parameter. If you specify nMaxRow not equal to GX_INVALID, DelayMergeCells will loop through all delayed ranges and check if any range is going beyond row nMaxRow. If yes, the range will be cut at nMaxRow. Objective Grid specifies this parameter when rows have been removed.

Remarks

Call DelayMergeCells when you want to recalculate merge cells.

Typical examples for calling this function are:

·When you want all cells to be reevaluated

     DelayMergeCells(CGXRange().SetTable());

·When you want some specific columns to be reevaluated

      DelayMergeCells(CGXRange().SetCols(nFromCol, nToCol+1));

All grid operations (changing the styles of cells, inserting, removing or dragging columns or rows, etc.) take care of properly calling DelayMergeCells. You will have to call this function very rarely.

The evaluation of floating cells is done on demand with the method EvalMergeCells when the user scrolls though the grid.

Control-Factory Specific ->

This method has been implemented using the abstraction mechanism as discussed in the chapter "Reducing the size of your application" in the user's guide. A call to the ImplementMergeCells method from within the control factory class' InitializeGridComponents method will make the concrete implementation of this method available to your application.

If no concrete implementation is available this method performs no action.

END Control-Factory Specific

See Also

CGXGridCore::SetMergeCellsMode CGXGridCore::EvalMergeCells

CGXGridCore

Class Overview | Class Members