listbox

`listbox()` creates a list selection control. Row indexes start at `0`; `-1` means no selection.

Creates a listbox object.

Example:

list = listbox().add('First').add('Second').row(0);

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

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

Adds a row at the end of the list.

Example:

list = listbox().add('probe.expr').add('warmup.expr');

Inserts a row. Index is clamped to the valid insert range.

Example:

list.insert(0, 'first.expr');

Removes a row by 0-based index.

Example:

list.remove(1);

Removes all rows and clears selection.

Example:

list.clear();

Selects a row by 0-based index. Use `-1` to clear selection.

Example:

list.row(0);

Simulates double-clicking a row by 0-based index.

Example:

list.double_click(0);

Sets a callback called when selection changes.

Example:

function selected(row)
{
    print('row: ', row);
}
 
list = listbox().on_select(selected);

Sets a callback called when a row is double-clicked.

Example:

function row_open(row)
{
    print('open row: ', row);
}
 
list = listbox().on_double_click(row_open);

programs = listbox()
    .position(20, 20)
    .size(220, 120)
    .add('probe.expr')
    .add('warmup.expr')
    .row(0);
 
window().title('ListBox').size(280, 190).add(programs).show();

Previous: combobox

Next: progressbar