358
VARLIST_BOX Directive
Control Variable List Box
Formats
1.Define/Create: VARLIST_BOX ctl_id,@(col,ln,wth,ht)[,ctrlopt]
2.Remove: VARLIST_BOX REMOVE ctl_id[,ERR=stmtref]
3.Disable/Enable: VARLIST_BOX {DISABLE | ENABLE}ctl_id[,ERR=stmtref]
4.Force Focus: VARLIST_BOX GOTO ctl_id[,ERR=stmtref]
5.Signal on Focus: VARLIST_BOX SET_FOCUS ctl_id,alt_ctl[,ERR=stmtref]
6.Load List: VARLIST_BOX LOAD ctl_id,dlm_list$[,ERR=stmtref]
7.Load Array: VARLIST_BOX LOAD ctl_id,array_name${ALL}[,ERR=stmtref]
Note: The curly braces enclosing {ALL} are part of the syntax.
8.Load/Delete Element: VARLIST_BOX LOAD ctl_id,index,{element$| *}[,ERR=stmtref]
9.Retrieve Element: VARLIST_BOX FIND ctl_id,index,var$[,ERR=stmtref]
10.Read Current Selection: VARLIST_BOX READ ctl_id,var$[,mode$][,ERR=stmtref]
11.Read Current Index: VARLIST_BOX READ ctl_id,var[,mode$][,ERR=stmtref]
12.Update Current Item: VARLIST_BOX WRITE ctl_id,element$[,ERR=stmtref]
13.Update Current Index: VARLIST_BOX WRITE ctl_id,index[,ERR=stmtref]
14.Clear Current Selection: VARLIST_BOX WRITE ctl_id,"" [,ERR=stmtref]
15.Report All Changes: VARLIST_BOX AUTO ctl_id[,ERR=stmtref]
Where:
@(col,ln,
Position and size of the variable list box region when expanded.
wth,ht)
Numeric expressions. Column and line coordinates for top left
corner, width in number of columns and height in number of lines.
(Note that list box height, when not expanded, is governed by the
system and is roughly 1.5 times the standard graphic font height.)
alt_ctl
CTL value to generate when the variable list box gains focus.
array_name$ Name of array to load into variable list box. String variable followed by {ALL}.
ctl_id
Unique logical identifier for a variable list box (any integer -32000 to
+32000). Avoid integers that conflict with keyboard definitions (e.g., 4
Use this value with the apostrophe operator to access Variable List Box
Control options. Supported options for VARLIST_BOX include:
ctrlopt
ERR=stmtref Error transfer
FNT="font,size[,attr]" Font name, size, optional properties
Refer to the 'FONT' Mnemonic, p.607 for details.