QG_SetAreaAlignment

QG_SetAreaAlignment(areaRef; horzAlign; vertAlign):errorCode
areaRef Longint QGrid area reference
horzAlign Longint Horizontal alignment
vertAlign Longint Vertical alignment
error Longint Error result

Set the cell alignment inside a QGrid area

Parameter areaRef is the QGrid area reference. If areaRef is not a valid QGrid area reference, qg_paramErr error is returned.

Parameters horzAlign and vertAlign specify how the grid cells will be aligned inside the QGrid area rectangle. Acceptable alignment values are listed below:

qg_AlignHorzLeft 0 Horizontally align to the left
qg_AlignHorzCenter 1 Horizontally align to the center
qg_AlignHorzRight 2 Horizontally align to the right
qg_AlignVertTop 0 Vertically align to the top
qg_AlignVertCenter 1 Vertically align to the center
qg_AlignVertBottom 2 Vertically align to the bottom

TIP Use the reserved value -1 to leave an alignment parameter unchanged while modifying the other.

NOTE If this command is not called, the default values are used (qg_AlignHorzLeft and qg_AlignVertTop for horizontal and vertical alignment respectively).

Example

   // Center the cells inside the xGrid area.

C_LONGINT($err)

$err:=QG_SetAreaAlignment (xGrid;qg_AlignVertCenter;qg_AlignHorzCenter)
ASSERT($err=qg_noErr)

Related commands

QG_GetAreaAlignment Get the current cell alignment in a QGrid area