95
DROP_BOX Directive
Control Drop Box
Formats
1.Define/Create: DROP_BOX ctl_id,@(col,ln,wth,ht)[,ctrlopt]
2.Remove: DROP_BOX REMOVE ctl_id[,ERR=stmtref]
3.Disable/Enable: DROP_BOX {DISABLE | ENABLE}ctl_id[,ERR=stmtref]
4.Hide/Show: DROP_BOX {HIDE | SHOW} ctl_id[,ERR=stmtref]
5.Force Focus: DROP_BOX GOTO ctl_id[,ERR=stmtref]
6.Signal on Focus: DROP_BOX SET_FOCUS ctl_id,alt_ctl[,ERR=stmtref]
7.Load via Delimited String: DROP_BOX LOAD ctl_id,dlm_list$[,ERR=stmtref]
8.Load via Array: DROP_BOX LOAD ctl_id,array_name${ALL}[,ERR=stmtref]
Note: The curly braces enclosing {ALL} are part of the syntax.
9.Load/Delete Index Element: DROP_BOX LOAD ctl_id,index,{element$| *}[,ERR=stmtref]
10.Retrieve Element: DROP_BOX FIND ctl_id,index,var$[,ERR=stmtref]
11.Read Current String: DROP_BOX READ ctl_id,var$[,mode$][,ERR=stmtref]
12.Read Current Index: DROP_BOX READ ctl_id,var[,mode$][,ERR=stmtref]
13.Reset Using Selection: DROP_BOX WRITE ctl_id,element$[,ERR=stmtref]
14.Reset Using Index: DROP_BOX WRITE ctl_id,index[,ERR=stmtref]
15.Clear Current Selection: DROP_BOX WRITE ctl_id, ""[,ERR=stmtref]
16.Report All Changes: DROP_BOX AUTO ctl_id[,ERR=stmtref]
Where:
@(col,ln,
Position and size of the drop box region when expanded. Numeric
wth,ht)
expressions. Column and line coordinates for top left corner, width in
number of columns and height in number of lines. (Note that drop
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 drop box gains focus.
array_name$ Name of array to load into drop box. String variable followed by {ALL}.
ctl_id
Unique logical identifier for the drop box (any integer -32000 to +32000).
Avoid integers that conflict with keyboard definitions (e.g., 4 cancels CTL=4
the apostrophe operator to access various Drop Box Properties.