ProvideX V8.20 > Language Reference > 2. Directives

178

OPT=char$ (See LIST_BOX OPT= Settings)

OWN=name$ Name assigned for automated testing of this control.

SEP=char$ Delimiter character. Hex or ASCII string value.

TBL=char$ Single character translation

TIP=text$ Mouse pointer message.

To change the colour, refer to the 'TC'= System Parameter, p.686.

dlm_list$

Delimited list of elements to load. String expressions.

Single element to load. Maximum string size 8kb. Use the asterisk *

element$

instead, to delete an element. For instance, LIST_BOX LOAD 86,4,*

removes element 4 from LIST_BOX 86.

index

Position of the element in the list box. Numeric expression. Integers:

the index of the 1st element is 1.

mode$

String variable. ProvideX returns a single-character hex value in this

variable to report the last method / keystroke the user chose to

activate the list box ($01$ for MOUSE-CLICK or $0D$ for Enter ).

stmtref

Program line number or label to transfer control to.

var[$]

Receives the value of the selected element (string variable) or index

(numeric variable).

LIST_BOX OPT= Settings

Available attribute/behaviour settings are listed below. Single characters may be

combined. Invalid settings are ignored. Some settings are also used to define specific

list view control types (OPT="r" for Report Style or OPT="l" for List Style ), and tree

view controls (OPT="e").

"!" Exclamation Mark. (Tree View only). Data has bitmaps or icons; e.g.,

0020 LIST_BOX 100,@(10,10,10,10),OPT="e,!"

If the OPT= setting includes "!" (as above), you can use LIST_BOX LOAD

statements to define bitmaps or icons for individual elements of a tree view.

ProvideX displays the bitmap or icon to the left of the related element.

Include the image filename in LIST_BOX WRITE statements to select

(highlight) a tree view element with a bitmap or icon; e.g.,

0030 LIST_BOX LOAD 100,"{Cat.bmp}Cat/{Dog.bmp}Dog/{Hog.ico}Pig/"

or

0040 LIST_BOX WRITE 100,"{Cat.bmp}Cat"

Bitmaps or icons you define for individual elements using LIST_BOX LOAD

statements will override any default bitmaps or icons (defined using FMT=).

"#" Pound Sign. Users can select more than one entry from the list box. (This option is

not supported for tree view.) If OPT="#", and items were loaded in a single

string, then when you read/write the element(s) highlighted in the list box, the

item(s) will be returned in the variable using either the delimiter from the

LIST_BOX LOAD statement or, as default delimiter, the SEP character.