ProvideX V8.20 > Language Reference > 2. Directives

181

"v" First Column highlight (Report View only). Controls the highlight style for

individual list boxes and overrides print mnemonic '+V'; e.g.,

LIST_BOX 100,@(10,10,10,10),OPT="r,v"

If the user clicks anywhere on a row, only the first column of the row will be

highlighted. See also, '+V' & '-V' Mnemonics, p.643.

"V" Full Row highlight (Report View only). Controls the highlight style for

individual list boxes and overrides print mnemonic '-V'; e.g.,

LIST_BOX 100,@(10,10,10,10),OPT="r,V"

If the user clicks anywhere on a row, the entire row will be highlighted. See

also, '+V' & '-V' Mnemonics, p.643.

"Z" Cursor changes to "resize" pointer if within 4 pixels from the edge of the control.

Description

Use the LIST_BOX directive to create a list box, a preset list of data elements from which

the user can select items. Standard list boxes contain a single column of data with no

formatting; however, this directive can be used to create a variety of list box styles.

List Box Styles

The following list box styles are defined using OPT= and FMT= settings:

· Formatted, p.186. Displays multiple elements in different columns with alignment

and width formatting, allowing colour mnemonics to be inserted into the data.

· List View, p.188. Lists a single element over multiple columns, where data wraps

from the bottom of one column to the top of the next.

· Report View, p.188. Displays multiple elements in different columns (like a

formatted list box) and allows column headings, sorting, bitmaps and other attributes.

· Tree View, p.191. Displays data grouped into a tree-like structure which

optionally may include + and - buttons to expand tree levels, dotted lines, and

state indicators.

Note: A standard Windows list box can only use vertical scrollbars. However, you can

use list view list boxes or grids to incorporate horizontal scrollbars into applications.

Users can select any element from a list of items you assign to the list box, but

variable input is not allowed. That is, the user can only select - not enter - values. If

you need a list box that allows both variable input and selection from a list, refer to

VARLIST_BOX Control List Box, p.358.

Dynamic Properties

The Apostrophe Operator can be used with the unique logical identifier (ctl_id) to

dynamically read and alter a wide variety of control attributes (properties) directly from

the programming language. Complete lists of the properties available for manipulating

LIST_BOX, LIST_VIEW, or TREE_VIEW objects are described in Chapter 7. Control

Object Properties, p.697.