Important Notice
The pages on this site contain documentation for very old MS-DOS software,
purely for historical purposes.
If you're looking for up-to-date documentation, particularly for programming,
you should not rely on the information found here, as it will be woefully
out of date.
LISTBOX (1.2)
◄Up► ◄Next► ◄Previous►
────────────────────────────────────────────────────────────────────────────
The Resource Compiler LISTBOX Statement
LISTBOX id, x, y, width, height[, style]
The LISTBOX statement creates commonly used controls for a dialog box or
window. The control is a rectangle containing a list of strings (such as
filenames) from which the user can select. The LISTBOX statement, which you
can use only in a DIALOG or WINDOW statement, defines the identifier,
dimensions, and attributes of a control window. The predefined class for
this control is WC_LISTBOX. If you do not specify a style, the default style
is WS_TABSTOP.
Field Description
────────────────────────────────────────────────────────────────────────────
id Specifies the control identifier. This value must be an integer in
the range 0 through 65,535, or a simple expression that evaluates to
a value in that range.
x Specifies the x-coordinate of the lower-left corner of the control.
This value must be an integer in the range 0 through 65,535 or an
expression consisting of integers and the addition (+) or
subtraction (-) operator. The coordinate is assumed to be in dialog
units and is relative to the origin of the dialog box, window, or
control containing the specified control.
y Specifies the y-coordinate of the lower-left corner of the control.
This value must be an integer in the range 0 through 65,535 or an
expression consisting of integers and the addition (+) or
subtraction (-) operator. The coordinate is assumed to be in dialog
units and is relative to the origin of the dialog box, window, or
control containing the specified control.
width Specifies the width of the control. This value must be an integer in
the range 1 through 65,535 or an expression consisting of integers
and the addition (+) or subtraction (-) operator. The width is in
¼-character units.
height Specifies the height of the control. This value must be an integer
in the range 1 through 65,535 or an expression consisting of
integers and the addition (+) or subtraction (-) operator. The
height is in 1/8-character units.
style Specifies the control styles. For a list of possible styles, see the
topic ◄List-box styles►. You can use the bitwise OR (|) operator to
combine styles.
Example
This example creates a list-box control whose identifier is 101.
LISTBOX 101, 10, 10, 100, 100
See Also
CONTROL, DIALOG, WINDOW
♦