Method XbpColumn():hiliteRow() Foundation

Displays a row of the data area in normal or highlight color.

:hiliteRow( <nRowPos>, <lHilite>, ;
            [<lFrame>], [<lRepaint>] ) --> lSuccess
<nRowPos> is a numeric value indicating the ordinal position of the row whose color is changed.
A logical value must be passed for <lHilite>. When .T. (true) is specified, the row is drawn in highlight color. The value .F. (false) selects the normal color.
The default value for <lFrame> is .T. (true) which causes a frame to be drawn around the row, if one is specified upon object creation. Passing the value .F. (false) suppresses the display of the frame.
<lRepaint> specifies whether or not the row is immediately re-displayed when the method returns. The default value is .T. (true) and the row is automatically re-displayed.

The method returns .T. (true) when the row is drawn in the selected color, or .F. (false) in case of a failure.


The method :hiliteRow() is called by the XbpBrowse object the XbpColumn object is embedded in when the browser wants to (de)highlight one row of the column's data area. The browse cursor is represented by a highlighted row.

This method must be overloaded in a user-defined XbpColumn class that embeds editable controls for editing a single cell of the browser. The edit control must be hidden when the browser passes .F. (false) to the method, and re-displayed when .T. (true) is passed.


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.