Exponenta Banner
exponenta event banner

listdlg

диалоговое окно «Создание списка»

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

Синтаксис

[indx, tf] = listdlg («ListString», список)
[indx, tf] = listdlg («ListString», список, имя, значение)

Описание

пример

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

list value - это список элементов, отображаемых в диалоговом окне.

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

Диалоговое окно содержит кнопки «Выбрать все», «Отмена» и «ОК». Можно ограничить выбор одним элементом, используя пару имя-значение, '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', то пользователи могут выбрать несколько элементов списка и кнопка Выбрать все отображается в диалоговом окне.

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

Пример: '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'

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

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

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

свернуть все

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

Логический выбор возвращен как 1 или 0.

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

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

Подробнее

свернуть все

Модальное диалоговое окно

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

См. также

|

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

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

Поддержка