Exponenta Banner

listdlg

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

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

Синтаксис

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

Описание

пример

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

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.

Больше о

свернуть все

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

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

Смотрите также

|

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

Документация MATLAB
Поддержка