uidropdown

(App Designer) Создает выпадающий компонент

Используйте только с App Designer или фигурами, созданными с функцией uifigure. При использовании GUIDE или функции figure, создайте выпадающий компонент с помощью uicontrol.

Синтаксис

dd = uidropdown
dd = uidropdown(parent)
dd = uidropdown(___,Name,Value)

Описание

dd = uidropdown создает выпадающее в новом окне фигуры и возвращает объект DropDown. MATLAB® вызывает функцию uifigure, чтобы создать фигуру.

пример

dd = uidropdown(parent) создает выпадающее в заданном родительском контейнере. Родительский элемент может быть созданным использованием Figure функции uifigure или одного из ее дочерних контейнеров.

пример

dd = uidropdown(___,Name,Value) задает свойства объектов с помощью одного или нескольких аргументов пары Name,Value. Используйте эту опцию с любыми комбинациями входных аргументов в предыдущих синтаксисах. Используйте пару Name,Value, Editable,'on', чтобы задать выпадающий компонент, который позволяет пользователю приложения вводить текст в выпадающий компонент или выбирать предопределенную опцию.

Примеры

свернуть все

Создайте выпадающий компонент.

fig = uifigure;
dd = uidropdown(fig);

Нажатие где угодно в выпадающем компоненте заставляет его открытый.

Создайте выпадающее с элементами по умолчанию в фигуре.

fig = uifigure('Position', [100 100 300 250]);
dd = uidropdown(fig);

Создайте выпадающий компонент и задайте опции.

fig = uifigure;
dd = uidropdown(fig, 'Items',{'Red','Yellow','Blue','Green'},...
                     'Value', 'Blue');

Определите значение, сопоставленное с выбранной опцией.

value = dd.Value
value =

Blue

По умолчанию свойство ItemsData пусто, таким образом, выпадающее значение компонента соответствует элементу, выбранному в выпадающем компоненте.

Объединенные значения данных с каждым выпадающим элементом компонента.

dd.ItemsData = [1 2 3 4];

Определите значение, сопоставленное с выбранной опцией.

value = dd.Value
value =

3

Заметьте, что, когда значение свойства ItemsData не пусто, значение выпадающего компонента является значением ItemsData, которое соответствует выбранному элементу значения Items.

fig = uifigure;
dd = uidropdown(fig, 'Editable','on');

Нажатие где угодно в выпадающем компоненте, кроме стрелки вниз, вставляет каре, позволяя пользователю ввести текст в выпадающем компоненте.

Создайте график и выпадающий компонент. Когда пользователь приложения делает выбор от выпадающего компонента, цвета изменений графика.

Сохраните следующий код в plotOptions.m на вашем пути MATLAB. Этот код создает окно, содержащее график и выпадающий компонент. Когда пользователь приложения изменяет выпадающий выбор компонента, обратный вызов ValueChangedFcn изменяет цвет графика.

function plotoptions
% Create figure and components:

fig = uifigure;

ax = uiaxes('Parent',fig,...
    'Position',[10 10 400 400]);

% Create a plot
x = linspace(-2*pi,2*pi);
y = sin(x);
p = plot(ax,x,y);
p.Color = 'Blue';

% Create drop-down component
dd = uidropdown(fig,...
    'Position',[430 210 100 22],...
    'Items',{'Red','Yellow','Blue','Green'},...
    'Value','Blue',...
    'ValueChangedFcn',@(dd,event) selection(dd,p));
end

% Create ValueChangedFcn callback:
    function selection(dd,p)
        val = dd.Value;
        p.Color = val;
    end

Запустите plotOptions. Выберите зеленый из выпадающего компонента, чтобы изменить цвет графика на зеленый.

Создайте выпадающий компонент и лампу. Когда пользователь приложения делает выбор от выпадающего компонента, изменений размера лампы.

Сохраните следующий код в lampSize.m на вашем пути MATLAB. Этот код создает окно фигуры, содержащее выпадающий компонент и лампу. Когда пользователь приложения изменяет выпадающий выбор компонента, обратный вызов ValueChangedFcn изменяет размер лампы.

function lampSize
% Create figure and components

fig = uifigure('Position',[100 100 300 275]);

lmp = uilamp(fig,...
    'Position',[100 30 20 20]);

dd = uidropdown(fig,...
    'Editable','on',...
    'Position',[84 204 100 20],...
    'Items',{'Size x 1','Size x 2','Size x 3','Size x 4'},...
    'ItemsData',[1 2 3 4],...
    'Value',1,...
    'ValueChangedFcn',@(dd,event) optionSelected(dd,lmp));
end

% Create ValueChangedFcn callback
function optionSelected(dd,lmp)
val = dd.Value;
s = [20 20];
switch val
    case {1, 2, 3, 4}  % User selected a defined option
        size = val * s;
        lmp.Position(3:4) = size;
    otherwise % User typed a value
        m = str2num(val);
        size = m * s;
        lmp.Position(3:4) = size;
end
end

Запустите lampSize и выберите различные варианты из выпадающего компонента.

Введите значение в выпадающем компоненте и нажмите Enter. Изменения размера лампы. (Если вы вводите большое значение, вам придется изменить размер фигуры, чтобы видеть лампу.)

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

свернуть все

Родительский контейнер, заданный как Figure, создал использование функции uifigure или одного из ее дочерних контейнеров: Tab, Panel, ButtonGroup или GridLayout.

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

Укажите необязательные аргументы в виде пар ""имя, значение"", разделенных запятыми. Имя (Name) — это имя аргумента, а значение (Value) — соответствующее значение. Имя должно появиться в кавычках. Вы можете задать несколько аргументов в виде пар имен и значений в любом порядке, например: Name1, Value1, ..., NameN, ValueN.

Пример: 'Элементы', {'Красный', 'Желтый', 'Синий'} задает опции, представленные в выпадающем компоненте.

Свойства, перечисленные здесь, являются подмножеством доступных свойств. Для полного списка см..DropDown Properties.

Значение, заданное как элемент Items или массивов ItemsData. По умолчанию Value является первым элементом в Items.

При определении Value, когда элемент Items выбирает выпадающий элемент, который совпадает с тем элементом. Если ItemsData не пуст, то Value должен быть установлен в элемент ItemsData, и выпадающее выберет связанный элемент в списке.

Выпадающие элементы, заданные как массив ячеек из символьных векторов или массив строк. Дублирующиеся элементы позволены. Выпадающие отображения компонента столько же опций сколько существуют элементы в массиве Items.

Пример: {'Красный', 'Желтый', 'Синий'}

Пример: {'1', '2', '3'}

Данные, сопоставленные с каждым элементом значения свойства Items, заданного как числовой массив 1 на n или массив ячеек 1 на n. Дублирующиеся элементы позволены.

Например, если вы устанавливаете значение Items к именам сотрудника, вы можете установить значение ItemsData к соответствующим идентификационным номерам сотрудника. Значение ItemsData не видимо к пользователю приложения.

Если количество элементов массива в значении ItemsData и значении Items не соответствует, одно из следующего происходит:

  • Когда значение ItemsData пусто, затем все элементы значения Items представлены пользователю приложения.

  • Когда значение ItemsData имеет больше элементов, чем значение Items, затем все элементы значения Items представлены пользователю приложения. MATLAB игнорирует дополнительные элементы ItemsData.

  • Когда значение ItemsData не пусто, но имеет меньше элементов, чем значение Items, единственные элементы значения Items, представленного пользователю приложения, являются теми, которые имеют соответствующий элемент в значении ItemsData.

Пример: {'Один', 'Два', 'Три'}

Пример: [10 20 30 40]

Доступное для редактирования состояние выпадающего компонента, заданного как 'off' или 'on'.

Если значением свойства Enable является 'off', то пользователь приложения не может изменить выпадающий текст компонента, даже если Доступным для редактирования значением свойства является 'on'.

Значение изменило обратный вызов, заданный как одно из этих значений:

  • Указатель на функцию.

  • Массив ячеек, в котором первый элемент является указателем на функцию. Последующие элементы массива ячеек являются аргументами, которые передаются в функцию обратного вызова.

  • Вектор символа, содержащий допустимое выражение MATLAB (не рекомендуемый). MATLAB оценивает это выражение в базовом рабочем пространстве.

Эта функция обратного вызова выполняется, когда пользователь выбирает различную опцию из выпадающего списка. Это не выполняется, если свойство Value изменяется программно.

Эта функция обратного вызова может получить доступ к определенной информации о взаимодействии пользователя с выпадающим. MATLAB передает эту информацию в объекте ValueChangedData в качестве второго аргумента к вашей функции обратного вызова. In App Designer, the argument is called event. You can query the object properties using dot notation., Например, event.PreviousValue возвращает предыдущее значение выпадающего. Объект ValueChangedData не доступен функциям обратного вызова, заданным как векторы символов.

В следующей таблице перечислены свойства объекта ValueChangedData.

СвойствоЗначение
ЗначениеВыпадающее значение компонента после нового взаимодействия пользователя приложения с ним.
PreviousValueВыпадающее значение компонента перед новым взаимодействием пользователя приложения с ним.
EditedЛогическое значение (0 или 1), который указывает, выполнялся ли обратный вызов в результате ввода значения в выпадающий компонент. Значение Edited равняется 1, когда пользователь приложения ввел в выпадающем компоненте и 0, когда пользователь приложения выбрал опцию из выпадающего компонента.
SourceКомпонент, который выполняет обратный вызов.
EventName'ValueChanged'

Для получения дополнительной информации о записи обратных вызовов, смотрите Обратные вызовы Записи в App Designer.

Местоположение и размер выпадающего компонента относительно родительского элемента, заданного как векторный [left bottom width height]. В этой таблице описываются каждый элемент в векторе.

ЭлементОписание
leftРасстояние от внутреннего левого края родительского контейнера к внешнему левому краю выпадающего компонента
bottomРасстояние от внутреннего базового края родительского контейнера к внешнему базовому краю выпадающего компонента
widthРасстояние между правыми и левыми внешними краями выпадающего компонента
высотаРасстояние между верхними и нижними внешними краями выпадающего компонента

Все измерения указаны в пикселях.

Значения Position соответствуют выделенной области родительского контейнера. Область векторной и растровой графики является областью в границах контейнера и не включает область, занятую художественными оформлениями, такими как панель меню или заголовок.

Пример: [100 100 100 22]

Введенный в R2016a

Была ли эта тема полезной?