ProvideX V8.20 > Language Reference > 2. Directives
148
Format 6: Force Focus
GRID GOTO ctl_id[,ERR=stmtref]
Use GRID GOTO directive (without col,row) to reactivate and force focus to the first
cell of your grid, ready for the next user action.
GRID GOTO ctl_id,col,row[,ERR=stmtref]
Use this format to go to a specific cell address (other than the first cell) and set the focus
on that cell, ready for the user's next action. You must include both column and row
coordinates in this format of the directive (not zero values).
Format 7: Signal on Focus
GRID SET_FOCUS ctl_id,alt_ctl[,ERR=stmtref]
Use the GRID SET_FOCUS format to define an alternate CTL value to generate
whenever focus shifts to the grid.
Format 8: Add Row/Column
GRID ADD ctl_id,col,row[,ERR=stmtref]
Use the GRID ADD format to add a row or column of blank cells to your grid. At
least one of the col,row values must be other than 0 zero.
Format 9: Load
GRID LOAD ctl_id,col,row,contents$[,ERR=stmtref]
Use GRID LOAD to load contents$ into the grid from a string variable or expression.
You must include both the column and the row for the address at which the load is
to start. If column and row are both 0 zero then the grid is cleared first.
ProvideX can load a number of columns and rows of data at a time. Column and row
separators are mandatory. Set the column separator using the SEP= option. Set your
row separator by including it as the last character in your data string. (ProvideX
treats the last character in the string as your row separator.)
Adding a New (Bottom) Row: Use row=0 to add a new row to the bottom of a grid;
i.e., GRID LOAD ctl,1,0,data$+ESC ! (Using ESC as the row delimiter)
Format 10: Delete Col/Row
GRID DELETE ctl_id,col,row[,ERR=stmtref]
Use the GRID DELETE format to delete a column or row from your grid. You can
identify a column to delete, a row to delete, or both.
Reminder: If you use zero (0) as your value for both column and row, ProvideX
interprets that as all columns and rows, respectively and will delete the entire grid.