BITLIST dialog element

Windows ✓Linux ✓macOS ⏳

Syntax

DIALOG ADD, BITLIST,<name>,<top>,<left>,<width>,<height>,<value>,<tooltip>,<styles>

Description

This dialog element works similar to a LIST dialog element, but supports the ability to display a 16 x 16 bitmap to the left of each item in the list. The bitmap is specified using a filename or resource filename, on the same line as the text for that line of the element, for example:

LIST ADD, BITLIST1,This is some text@fsep()#bitmap.bmp

The filename or resource filename must be the last thing on the line, and must be separated from the text by the current field separator character (see OPTION FIELDSEP). Care should be taken to ensure that the current field separator character is something that does not appear in the text itself.

The dialog element works like a string list, and data can be transferred to and from it using LIST commands.

Styles

In addition to user-defined styles to change the default font style and color, the following styles may be used with this dialog element:

CLICK The element will generate a <name>CLICK event when an item is selected from the list.
DBLCLICK The element will generate a <name>DBLCLICK event when an item in the list is double-clicked.
HEIGHT <nn> This style can be used to adjust the spacing between lines in the list. By default, the height of each line is 18 pixels. Note that, unlike a standard list box, the height of each line is not automatically adjusted to take account of the text height. The value of the HEIGHT style is the only thing that governs the line height.
MULTI When this style is used, the list box supports multiple selections using the usual Windows method: holding the Shift key while you click to select a block of items; using the Ctrl key while you click to select individual items. The number of items selected can be obtained using the @SELECTED function, and a string containing all the selected items can be obtained using @ITEMS.
SORTED Specifies whether the list items are to be maintained in ASCII order or not.
<cursor style> The cursor will change to the named style when the pointer is over the dialog element. Valid styles are: NONE, ARROW, CROSS, IBEAM, SIZE, NESW, NS, NWSE, WE, UP, WAIT, DRAG, NODROP, HSPLIT, VSPLIT, MULTI, SQL, NO, HELP, HAND.

See also