CExtGridWnd::GridCellJoinSet

Professional User Interface Suite, Copyright FOSS Software Inc. Help Published with Permission.

Sets how a cell is merged with it neighboring cells and returns true if succeeded or false otherwise.

virtualbool GridCellJoinSet(
   CSize sizeJoin,
   LONG nColNo,
   LONG nRowNo,
   INT nColType = 0,
   INT nRowType = 0,
   bool bValidateJoin = false,
   bool bCheckCellsPresentInJoinedArea = false,
   bool bCheckFrozenAreaIntersection = true
);

Parameters

sizeJoin
Specifies how the cell should be merged with its neighboring cells. The possible values and their meanings are given in this table.
nColNo
Column index.
nRowNo
Row index.
nColType
Type of the column (0 - inner column, -1 - outer column on left, 1 - outer column on right).
nRowType
Type of the row (0 - inner row, -1 - outer row at top, 1 - outer row at bottom).
bValidateJoin
Indicates that if bValidateJoin is true, the merge operation is checked that the cells to be merged are located within the grid; this is not checked otherwise. If the check fails, the method returns false.
bCheckCellsPresentInJoinedArea
Indicates that if bCheckCellsPresentInJoinedArea is true, the merge operation is checked that the range of cells to be merged do not intersect with some other range of merged cells. This is not checked otherwise. If the check fails, the method returns false.
bCheckFrozenAreaIntersection
Indicates that if bCheckFrozenAreaIntersection is true, the merge operation is checked that the range of cells to be merged do not intersect with frozen columns. This is not checked otherwise. If the check fails, the method returns false.

See Also

CExtGridWnd Overview | Class Members | Hierarchy Chart