combobox

`combobox()` creates a drop-down list. Item indexes start at `1`; `0` means no selection. Adding text `—` creates a separator and does not increase `count`.

Creates a combobox object.

Example:

combo = combobox().add('One').add('Two').item(1);

Properties are read-only. Use methods to change GUI object state.

`clone()` is not supported for `combobox`.

Adds an item. Text `—` adds a separator. Separators are displayed in the list but are not counted by `count` and do not receive item indexes.

Example:

combo = combobox()
    .add('One')
    .add('---')
    .add('Two');

Sets current displayed text.

Example:

combo = combobox().text('Custom');

Selects item by 1-based index. `0` clears selection. Index is clamped to `0..count`.

Example:

combo = combobox().add('One').add('Two').item(2);

Sets a callback called when selection changes.

Example:

function mode_changed(index)
{
    print('mode index: ', index);
}
 
combo = combobox().on_change(mode_changed);

mode = combobox()
    .position(20, 20)
    .size(180, 26)
    .add('Roughing')
    .add('Finishing')
    .item(1);
 
window().title('ComboBox').size(240, 100).add(mode).show();

Previous: slider

Next: listbox