ProvideX V8.20 > Language Reference > 2. Directives
142
GRID Directive
        Control Grid
Formats
1.Define/Create: GRID ctl_id,@(col,ln,wth,ht)[,ctrlopt]
2.Remove: GRID REMOVE ctl_id[,ERR=stmtref]
3.Disable/Enable: GRID {DISABLE | ENABLE} ctl_id[,ERR=stmtref]
4.Lock/Unlock: GRID {LOCK | UNLOCK} ctl_id,col,row[,width,height][,ERR=stmtref]
5.Hide/Show: GRID {HIDE | SHOW} ctl_id[,ERR=stmtref]
6.Force Focus: GRID GOTO ctl_id[,col,row][,ERR=stmtref]
7.Signal on Focus: GRID SET_FOCUS ctl_id,alt_ctl[,ERR=stmtref]
8.Add Row/Column: GRID ADD ctl_id,col,row[,ERR=stmtref]
9.Load: GRID LOAD ctl_id,col,row,contents$[,ERR=stmtref]
10.Delete Row/Column: GRID DELETE ctl_id,col,row[,ERR=stmtref]
11.Clear: GRID CLEAR ctl_id,col,row[,width,height][,ERR=stmtref]
12.Read First Cell: GRID READ ctl_id,col,row,var$,eom$[,ERR=stmtref]
13.Read Next: GRID READ NEXT ctl_id,col,row,var$,eom$[,ERR=stmtref]
14.Select Range: GRID SELECT ctl_id,col,row[,width,height][,ERR=stmtref]
15.Select Read: GRID SELECT READ ctl_id,col,row[,ERR=stmtref]
16.Select Read Next: GRID SELECT READ NEXT ctl_id,col,row[,ERR=stmtref]
17.Select Reset: GRID SELECT RESET ctl_id[,ERR=stmtref]
18.Find or Retrieve: GRID FIND ctl_id,col,row,var$[,ERR=stmtref]
19.Write Setting: GRID WRITE ctl_id,col,row,contents$[,ERR=stmtref]
20.Report all Changes: GRID AUTO ctl_id[,ERR=stmtref]
Where:
@(col,ln,
Position and size of the grid region on the screen. Numeric
wth,ht)
expressions. Column and line coordinates for top left corner, width in
number of columns and height in number of lines.
alt_ctl
Alternate CTL value.
col,row
Column and row refer to cell location / coordinates. Numeric
expressions.
contents$ Value(s) to be written to the cell(s) or settings. String expression(s).
ctl_id
Unique logical identifier for the grid (any integer -32000 to +32000). Avoid
integers that conflict with keyboard definitions (e.g., 4 cancels CTL=4 for
the F4 key) or Negative CTL Definitions, p.822. Use this value with the
apostrophe operator to access various Grid Properties.
Control options. Supported options for GRID include:
ctrlopt
ERR=stmtref Error transfer
FMT=def$ (See Format Definition, p.144)