ProvideX V8.20 > Language Reference > 2. Directives
185
LIST_BOX READ ctl_id,var$[,mode$][,ERR=stmtref]
Read Current Selection. When you use LIST_BOX READ with a string variable, you
can return the value of the currently selected element and the method used to make
the selection (mode$).
LIST_BOX READ ctl_id,var[,mode$][,ERR=stmtref]
Read Current Index. If you use LIST_BOX READ with a numeric variable, you can return
the element by index and the user's method of selection (mode$) from the list box.
Note: If LIST_BOX READ includes an OPT="A" setting, all changes will have an effect
on the EOM or mode$ value returned during the read.
Formats 13 and 14: Write Current Selection
Use the LIST_BOX WRITE formats to make the element the current selection,
highlighted in the list box.
LIST_BOX WRITE ctl_id,element$[,ERR=stmtref]
Write Selection. The string expression to write an element to a list box as the current selection
must exactly match the value of one of the elements in the list box. Otherwise ProvideX
returns Error #11: Record not found or Duplicate key on write.
Writing data with bitmaps or icons. Imagines can be included with specific data elements
that are being written into a list box. The syntax for including images under LIST_BOX
LIST_BOX WRITE ctl_id,index[,ERR=stmtref]
Write Index. You can write the current selection to a list box by using its index.
Note: A WRITE to the list box using an index of 0 zero will reset all highlighted lines.
Format 15: Clear Current Selection
LIST_BOX WRITE ctl_id,"" [,ERR=stmtref]
Use this format to clear the currently selected entry in a list box.
Format 16: Report All Changes
LIST_BOX AUTO ctl_id[,ERR=stmtref]
Use the LIST_BOX AUTO format to have ProvideX generate a CTL value
automatically whenever the current selection is changed. Use this to track changes to
the highlighted selection in a list box.