ProvideX V8.20 > Language Reference > 2. Directives

96

Control options. Supported options for DROP_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.

KEY=char$ Hot key

MSG=text$ Message line

MNU=ctl CTL value associated with right-click menu event.

TBL=char$ Single character translation

TIP=text$ Mouse pointer message.

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

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

OPT=char$ Attribute/behaviour settings:

"A" - Auto. Generate CTL signal when a new element is highlighted.

"B" - No border. Drop box will not have a border.

"d" - Permanently Disabled. Drop box cannot be enabled.

"D" - Initially Disabled. User cannot access the drop box.

"h" - Permanently Hidden. Drop box cannot be shown.

"H" - Initially Hidden. Drop box is initially hidden.

"G" - Global. Keep active on focus change to new/non-concurrent window.

"S" - Signal. Generate CTL value but without shifting focus.

"s" - Scroll. Allow scroll within resizable/scrollable dialogue box.

"T" - Strip trailing spaces.

"X" - Signal when focus exits from control.

"Z" - Cursor changes to "resize" pointer if within 4 pixels of control.

Some characters may be combined. Invalid settings are ignored.

dlm_list$

Delimited list of elements to load. String expressions.

element$

Single element to load. String expression. You can use the asterisk *

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

will remove element 4 from the DROP_BOX.

index

Position of the element in the drop 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 drop box ($01$ for MOUSE-CLICK or $0D$ for Enter ).

var[$]

Variable to receive value. String variable for element/numeric for index.

Description

Use the DROP_BOX directive to create and manipulate drop box control objects on

the screen. A drop box normally displays a single line on the screen with a

DOWN-ARROW on the right side. The user can select any element from a list of items you

assign to the drop box, but variable input is not allowed. That is, the user can only

select, not enter, values. To view the list, the user clicks on the DOWN-ARROW. When the

user selects a drop box item, the associated ctl_id is used to generate a CTL value.