Method XbpMultiCellGroup():setCell() Foundation

Defines the value to be displayed in a cell.

:setCell( <nRowPos>, <nColPos>, <xValue>, ;
                             [<lRepaint>] ) --> lSuccess
<nRowPos> is a numeric value indicating the ordinal row position of the cell whose value is changed.
<nColPos> is a numeric value indicating the ordinal column position of the cell.
This parameter specifies the value to be displayed in the cell. It can be of the data type "C", "D", "L" or "N". For columns with a display type set to XBPCOL_TYPE_BITMAP or XBPCOL_TYPE_ICON, <xValue> may also be of type "O" (XbpBitmap or XbpIcon object). This allows loading images from disk, for example. Furthermore, if a transparent color has been defined for the bitmap object, transparent areas within the image are automatically replaced with the background color defined for the individual cells in the column.

If an XbpBitmap or XbpIcon object is passed for parameter <xValue>, either :load() or :loadFile() must have been called previously. If the bitmap is constructed in memory, method :make() must have been called. Furthermore, reusing the same bitmap or icon object to load a different image is discouraged as long as the object is used as the value for a cell. Instead, a new bitmap or icon object should be created for each individual image loaded from disk.

<lRepaint> specifies whether or not the cell is immediately re-displayed when the method returns. The default value is .T. (true) and the cell is automatically re-displayed.

The method returns .T. (true) when the value is assigned to the cell, or .F. (false) in case of a failure.


If you see anything in the documentation that is not correct, does not match your experience with the particular feature or requires further clarification, please use this form to report a documentation issue.