listdlg
Opens a list selection dialog box.
📝Syntax
[selection, ok] = listdlg(Name, Value)
📥Input Arguments
Parameter Description
'ListString' Required list entries. Use a cell array of character vectors or a string array.
📤Output Arguments
Parameter Description
selection Row vector of selected one-based indices. Empty when canceled.
📄Description

listdlg displays selectable text entries and returns the selected indices.

💡Examples
Preview a list selection dialog layout.
f = dialog('Name', 'List Selection', 'WindowStyle', 'normal', 'Position', [100 100 360 220]);
uicontrol(f, 'Style', 'text', 'String', 'Select a color:', 'Position', [28 164 150 22]);
uicontrol(f, 'Style', 'listbox', 'String', {'red', 'green', 'blue'}, 'Value', 2, 'Position', [30 70 290 90]);
uicontrol(f, 'Style', 'pushbutton', 'String', 'OK', 'Position', [170 28 70 24]);
uicontrol(f, 'Style', 'pushbutton', 'String', 'Cancel', 'Position', [250 28 70 24]);
Example illustration
Select several entries from a list.
items = {'low', 'medium', 'high'};
[selection, ok] = listdlg('ListString', items, 'SelectionMode', 'multiple', 'InitialValue', [1 3]);
if ok, disp(selection); end
🔗See Also
inputdlgquestdlg
🕔Version History
Version Description
2.0.0 Updated dialog API help.
Edit this page on GitHub