uiknob

Создайте компонент кнопки

Описание

kb = uiknob создает кнопку в новом окне рисунка и возвращает Knob объект. MATLAB® вызывает uifigure функция, чтобы создать фигуру.

kb = uiknob(style) задает стиль кнопки.

пример

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

пример

kb = uiknob(parent,style) создает кнопку заданного стиля в заданном родительском контейнере.

пример

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

Примеры

Создание непрерывной кнопки

fig = uifigure;
kb = uiknob(fig);

Создание дискретной кнопки

Задайте Figure возразите как родительский контейнер.

fig = uifigure('Position',[100 100 300 250]);
kb = uiknob(fig,'discrete');

Установка и доступ к непрерывным значениям свойств кнопки

Создайте непрерывную кнопку в фигуре.

fig = uifigure;
kb = uiknob(fig);

Определите пределы кнопки.

limits = kb.Limits
limits =

     0   100

Измените пределы и значение кнопки.

kb.Limits = [-10 10];
kb.Value = 5;

Установка и Доступ к значениям свойств

Создайте дискретную кнопку.

fig = uifigure;
kb = uiknob(fig,'discrete');

Измените состояния кнопки. Сопоставьте определенные данные с состояниями кнопки путем конфигурирования ItemsData. В этом случае, ItemsData отражает температуры в градусах Фаренгейт.

kb.Items = {'Cold', 'Warm', 'Hot'};
kb.ItemsData = {32, 80, 212};

Получите температуру, сопоставленную с текущим значением кнопки.

degrees = kb.Value
degrees =

    32

Ответ кода на измененные дискретные настройки кнопки

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

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

function displayKnobValue
% Create figure window

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

% Create the text field
txt = uieditfield(fig,'text',...
    'Position', [69 82 100 22]);

% Create the knob
kb = uiknob(fig,'discrete',...
    'Position',[89 142 60 60],...
    'ValueChangedFcn',@(kb,event) knobTurned(kb,txt));
end

% Code the knob callback function
function knobTurned(knob,txt)
txt.Value = knob.Value;
end

Запустите displayKnobValue, и затем поверните кнопку. Когда вы отпускаете кнопку мыши, поле редактирования обновляется, чтобы отразить новое значение кнопки.

Ответ кода на измененные непрерывные настройки кнопки

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

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

function showKnobValue
% Create figure window and components
fig = uifigure('Position',[100 100 283 275]);

% Create label
lbl = uilabel(fig,...
    'Position',[218 177 50 15],...
    'Text','0');

% Create knob
kb = uiknob(fig,...
    'Position',[89 142 60 60],...
    'ValueChangedFcn', @(kb,event) knobTurned(kb,lbl));
end

% Create ValueChangedFcn callback
function knobTurned(kb,lbl)
num = kb.Value;
lbl.Text = num2str(num);
end

Запустите showKnobValue и поверните кнопку. Когда вы отпускаете кнопку мыши, метка обновляется, чтобы отразить новое значение кнопки.

Ответ кода на изменение непрерывных настроек кнопки

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

Скопируйте и вставьте следующий код в файл с именем showchangingvalue.m на вашем пути MATLAB. Этот код создает окно, содержащее непрерывную кнопку и поле метки. Это задает ValueChangingFcn коллбэк, чтобы продолжить обновлять метку как кнопку превращается.

function showChangingValue
% Create figure window
fig = uifigure('Position',[100 100 283 275]);

% Create numeric edit field
num = uieditfield(fig,'numeric',...
    'Position',[69 82 100 20]);

% Create knob
kb = uiknob(fig,...
    'Position',[89 142 60 60],...
    'ValueChangingFcn',@(kb,event) knobTurned(kb,event,num));
end

% Create ValueChangingFcn callback
function knobTurned(kb,event,num)
num.Value = event.Value;
end

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

Ответ кода на недопустимую установку кнопки

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

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

function increaseOnly
% Create figure window
fig = uifigure('Position',[100 100 400 275]);

% Create knob
kb = uiknob(fig,...
    'Position',[150 125 60 60],...
    'ValueChangedFcn',@(kb,event) nValChanged(kb,event,fig));
end

% Create ValueChangedFcn callback
function nValChanged(kb,event,fig)
newvalue = event.Value;
previousvalue = event.PreviousValue;
if previousvalue >  newvalue
   uialert(fig, 'Increase value only. Value set to previous value.',...
        'Invalid Value');
   kb.Value = previousvalue;
end
end

Запустите increaseOnly, увеличьте значение кнопки, и затем попытайтесь уменьшить его. Когда вы пытаетесь уменьшить значение, ошибочное диалоговое окно отображается, и значение вернулось к предыдущему допустимому значению. Можно только увеличить значение кнопки.

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

свернуть все

Стиль кнопки, заданной как одно из следующих значений:

СтильВнешний вид
'continuous'

'discrete'

Родительский контейнер, заданный как Figure объект создал использование uifigure функция или один из ее дочерних контейнеров: TabПанельГруппа кнопок, или GridLayout. Если вы не задаете родительский контейнер, MATLAB вызывает uifigure функция, чтобы создать новый Figure объект, который служит родительским контейнером.

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

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

Каждый тип поддержки объектов кнопки различный набор свойств. Для полного списка свойств и описаний для каждого типа, смотрите связанную страницу свойств.

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

Функции

Свойства

Введенный в R2016a