uidropdown

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

Синтаксис

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. Выберите green из выпадающего компонента, чтобы изменить цвет графика на зеленый.

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

Сохраните следующий код в 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. Если никакой контейнер не задан, MATLAB вызывает функцию uifigure, чтобы создать новый объект Figure, который служит родительским контейнером.

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

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

Пример: 'Items',{'Red','Yellow','Blue'} задает опции, представленные в выпадающем компоненте.

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

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

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

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

Пример: {'Red','Yellow','Blue'}

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

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

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

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

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

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

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

Пример: {'One','Two','Three'}

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

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

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

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

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

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

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

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

Эта функция обратного вызова может получить доступ к определенной информации о взаимодействии пользователя с выпадающим. MATLAB передает эту информацию в объекте ValueChangedData в качестве второго аргумента к вашей функции обратного вызова. В App Designer аргумент называется событием. Вы можете запросить свойства объекта с помощью записи через точку. Например, event.PreviousValue возвращает предыдущее значение выпадающего. Объект ValueChangedData не доступен функциям обратного вызова, заданным как векторы символов.

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

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

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

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

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

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

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

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

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

Функции

Свойства

Введенный в R2016a