Exponenta Banner

listdlg

Создайте диалоговое окно выбора списка

Свернуть все на странице

Синтаксис

[indx,tf] = listdlg('ListString',list)
[indx,tf] = listdlg('ListString',list,Name,Value)

Описание

пример

[indx,tf] = listdlg('ListString',list) создает модальное диалоговое окно, которое позволяет пользователю выбрать один или несколько элементов из заданного списка.

The list значение - это список элементов, доступных в диалоговом окне.

Функция возвращает два выходных аргументов, indx и tf содержит информацию о выбранных пользователем элементах.

Диалоговое окно включает Select all, Cancel и OK кнопки. Вы можете ограничить выбор одним элементом, используя пару "имя-значение", 'SelectionMode','single'.

пример

[indx,tf] = listdlg('ListString',list,Name,Value) задает дополнительные опции, используя один или несколько аргументы пары "имя-значение". Для примера, 'PromptString','Select a Color' представляет Select a Color над списком.

Примеры

свернуть все

list = {'Red','Yellow','Blue',...                   
'Green','Orange','Purple'};
[indx,tf] = listdlg('ListString',list);


d = dir;
fn = {d.name};
[indx,tf] = listdlg('PromptString',{'Select a file.',...
    'Only one file can be selected at a time.',''},...
    'SelectionMode','single','ListString',fn);

Входные параметры

свернуть все

Список элементов для представления в диалоговом окне в виде вектора символов, массива ячеек векторов символов или строковых массивов. Для массивов ячеек и строковых массивов каждый элемент обычно соответствует отдельному элементу списка. Если вы вставляете символы новой строки, используя sprintfэто приводит к появлению дополнительных элементов списка. Например, следующий код приводит к четырем элементам списка, хотя существует только три элемента массива ячеек. 

f = listdlg('ListString', ...
            {'John Smith' ...
             sprintf('Cecelia\nPayne-Gaposchkin') ...
             'Gina Peters'});

Пример: {'Ellen','Varun','Haruko','Roger'}

Аргументы в виде пар имя-значение

Задайте необязательные разделенные разделенными запятой парами Name,Value аргументы. Name - имя аргумента и Value - соответствующее значение. Name должны находиться внутри кавычек. Можно задать несколько аргументов в виде пар имен и значений в любом порядке Name1,Value1,...,NameN,ValueN.

Пример: 'SelectionMode,'single','InitialValue',4 указывает, что пользователь может выбрать один элемент из списка и что при открытии диалогового окна выбирается четвертый элемент из списка.

Запрос окна списка, заданный как вектор символов, массив ячеек из векторов символов или строковые массивы. Подсказка появится над полем списка.

Если вы задаете подсказку в качестве вектора символов, которая больше ширины диалогового окна, то подсказка зажимается. Чтобы создать многострочный список, задайте запрос как массив ячеек или строковые массивы. Пропуски линий происходят между каждым элементом массива. Длинные элементы переносятся, чтобы соответствовать диалоговому окну.

Пример: 'PromptString','Select a catalog number:'

Перечислите режим выбора, заданный как разделенная разделенными запятой парами, состоящая из 'SelectionMode' и любой из них 'multiple' или 'single'.

  • Если для режима выбора задано значение 'multiple'затем пользователи могут выбрать несколько элементов списка и отобразить кнопку Select all в диалоговом окне.

  • Если для режима выбора задано значение 'single'затем пользователи могут выбрать только один элемент списка, и кнопка Select all не отображается в диалоговом окне.

Пример: 'SelectionMode','single'

Размер списка в пикселях, заданный как разделенная разделенными запятой парами, состоящая из 'ListSize' и двухэлементный вектор, [width height].

Пример: 'ListSize',[150,250]

Выбранные элементы списка, заданные как скалярное значение индекса при 'SelectionMode' установлено в 'single' и задается как вектор индексов при 'SelectionMode' установлено в 'multiple'. Индексы указывают, какие строки в списке будут выбраны при открытии диалогового окна. Для примера:

  • Если 'InitialValue' установлено в 3, затем при открытии диалогового окна выбирается третий элемент из верхней части списка.

  • Если 'InitialValue' установлено в [3 4], затем при открытии диалогового окна выбираются третий и четвертый элементы из верхней части списка.

Пример: 'InitialValue',5

Пример: 'InitialValue',[2 5]

Заголовок диалогового окна, заданный как вектор символов или строковый скаляр.

Пример: 'Name','File Selection'

OK метка кнопки, заданная как вектор символов или строковый скаляр.

Пример: 'OKString','Apply'

Cancel метка кнопки, заданная как вектор символов или строковый скаляр.

Пример: 'CancelString','No Selection'

Выходные аргументы

свернуть все

Индекс к выбранным строкам, возвращенный как массив индексов. Индексы строк соответствуют выбранным пользователем параметрам из списка. Если пользователь нажимает Cancel, Esc или нажимает кнопку закрытия в строке заголовка диалогового окна, indx значение возвращается как пустой массив.

Логика выбора возвращается следующим 1 или 0.

Логическое значение выбора указывает, сделал ли пользователь выбор. Если пользователь кликнет OK, дважды кликнет элемент списка или нажимает Return, то tf возвращаемое значение равняется 1.

Если пользователь нажимает Cancel, Esc или кнопку закрытия (X) в строке заголовка диалогового окна, tf возвращаемое значение 0.

Подробнее о

свернуть все

Диалоговое окно Modal

Модальное диалоговое окно препятствует взаимодействию пользователя с другими MATLAB® окна перед ответом. Для получения дополнительной информации смотрите WindowStyle в разделе Свойств фигуры».

См. также

|

Представлено до R2006a

Документация MATLAB

Поддержка