ProvideX V8.20 > Language Reference > 2. Directives
188
List View
A list view list box is similar to a standard list box, but it displays the data as a
continuous list over multiple columns. When loading a list view you can place an
optional bitmap or icon to the left of the data element. This type of list box is created
by adding OPT="l" (lower case L) to the LIST_BOX definition (see Format 1:
Define/Create List Box, p.182); e.g.,
0200 LIST_BOX 100,@(2,14,12,6),FNT="*",OPT="l"
Use FMT= to override the default column sizing of the list view (only "Ln", "Rn",
and "Cn" alignment are supported). To indicate that a bitmap/icon is to be placed to
the left of the data element, include a set of {} curly braces in the FMT= string. See
Loading Data with Images, p.183. This type of list box also allows use of the
partial match (OPT="p")option (see LIST_BOX OPT= Settings, p.178).
Report View
A report view list box displays multiple data elements in table form (similar to a
Formatted list box), but can also include optional headings, sorting, and other
attributes. For a more elaborate version of this list box style, use a GRID, p.142.
When loading a report view, you can include a bitmap/icon to be displayed at the
beginning of each row/line. This type of list box is created by adding OPT="r" (lower
case r) to the LIST_BOX definition (see Format 1: Define/Create List Box, p.182); e.g.,
LIST_BOX 10000,@(5,5,35,10),FMT="[Company]L10 [Vendor]C6
[Amount]#R12",OPT="r"
Report View Format Options
Use FMT= to define column alignment, titles, sorting, and bitmap placement:
Column Alignment Codes for column alignment are described under FMT=
Alignment Settings, p.186; e.g.,
LIST_BOX 10000,@(5,5,35,10),FMT="[Company]L10 ..."
indicates that column 1 is left justified and 10 columns wide.
Column Titles
Place title text within square brackets ahead of the alignment
code to indicate column titles; e.g., ... [Company]L10.
Bitmaps or Icons To indicate that a bitmap/icon is to be placed at the beginning of
the row/line, include a set of {} curly braces in the FMT= string.
When using different images, ensure that they are all the same
size. If different sizes are used, ProvideX treats the size of the
first bitmap/icon as the size of all images. If you use internal
bitmaps, ProvideX converts the background light gray to match
the background colour of the LIST_BOX entries. See Loading
Data with Images, p.183.
Date Sorting
Date code combinations define date values for sorting purposes.
Up to three characters can be used to show the order of the date as
it appears in the data (MD, DMY, MDY, YMD ...).