SetCellColor

Change the color of an individual cell

status = %AX_CALL(axlist_id, "SetCellColor", row, column, color, background_flag)

Return value

status

Returns true if successful, otherwise false. (n)

Arguments

axlist_id

The ID for the ActiveX Toolkit list. This ID can be retrieved with L_STATUS. (n)

row

The row number of the cell whose color is being modified. (n)

column

The column number of the cell whose color is being modified. (n)

color

The color (RGB value) to apply to the cell. (n)

background_flag

One of the following: (n)

0 = Change text color.

1 = Change background color.

Discussion

The SetCellColor method sets either the text or background color for a specified cell. The specified color overrides any color settings specified by the BackColor, DarkItemColor, or LightItemColor properties, or any field color specified in the window script or by the I_FLDMOD subroutine. See the GetCellColor Discussion for information on RGB values.

See also

GetCellColor method
%AX_CALL routine

Examples

The following example sets the text color of the third column in the currently selected row to red.

xcall l_status(listid, D_LAXCTRL, axctrl, D_LCURITM, curr)
xcall ax_call(axctrl, "SetCellColor", curr, 3, RGB_VALUE(255,0,0), 0)