4. System Classes : TableField Class : SetInputFocus Method
 
Share this page                  
SetInputFocus Method
The SetInputFocus method sets a frame's input focus to a specific cell in a table field.
This method has the following syntax:
integer = TableField.SetInputFocus([row = integer] [, column = name(varchar(256))])
This method has the following parameters:
row
Identifies the row that contains the target cell
column
Identifies the column that contains the target cell. If you do not specify a row, the default is row one. If you do not specify a column, the default is the first displayed column in the table field. If you specify both parameters, you must separate them with a comma.
The change in focus occurs at the end of the current event block and triggers all appropriate Exit, SetValue, and Entry events.
If the parameters are valid, this method returns ER_OK. Otherwise, it returns a non-zero value. Descriptions of system constant values and their numeric equivalents are listed in Error Codes (see Error Codes).
You cannot use this method to set the focus to a cell of a nested table field or a composite field nested in a table field.