BITCOMBO dialog element

Windows ✓Linux ✓macOS ⏳

Syntax

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

Description

This dialog element works similar to a COMBO dialog element with the LIST style, 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, BITCOMBO1,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 drop-down list.
EXIT the element causes a <name>EXIT event to be generated when the combo box loses the input focus.
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 combo 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.
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