QG_SetNumCells
| QG_SetNumCells(areaRef; sizeExpression):errorCode | |||
|---|---|---|---|
 |
areaRef | Longint | QGrid area reference |
|
sizeExpression | Text | Expression giving the number of grid cells |
 |
error | Longint | Error result |
Set the 4D expression that calculates the grid size
Parameter areaRef is the QGrid area reference. If areaRef is not a valid QGrid area reference, qg_paramErr error is returned.
Parameter sizeExpression holds the 4D expression to be used for calculating the number of cells.
QGrid uses this expression to calculate how many cells the grid will contain, so the expression must return a long integer value.
If the number of cells changes while the plug-in area is running, inform the plug-in that it must recalculate the number of cells by calling QG_UpdateArea with the update type set to qg_Update_Grid.
Example
// Setup a grid to reflect the current selection of table [Photos]. C_LONGINT($err) C_TEXT($expression) $expression:="Records in selection([Photos])" $err:=QG_SetNumCells (xGrid;$expression) ASSERT($err=qg_noErr)
Related commands
| QG_GetNumCells | Get the current grid size expression |
| QG_UpdateArea | Trigger an update of the QGrid area content |