uicheckbox

(App Designer) компонент флажка Create

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

Синтаксис

cbx = uicheckbox
cbx = uicheckbox(parent)
cbx = uicheckbox(___,Name,Value)

Описание

cbx = uicheckbox создает флажок в новом окне фигуры и возвращает объект CheckBox. MATLAB® вызывает функцию uifigure, чтобы создать фигуру.

пример

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

пример

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

Примеры

свернуть все

Создайте флажок.

fig = uifigure;
cbx = uicheckbox(fig);

Создайте панель. Затем создайте флажок в панели.

fig = uifigure;
pnl = uipanel(fig);
cbx = uicheckbox(pnl);

Создайте флажок и задайте значения свойств.

fig = uifigure;
cbx = uicheckbox(fig, 'Text','Show Value',...
                  'Value', 1,...
                  'Position',[150 50 102 15]);

Снимите флажок.

cbx.Value = 0;

Определите размер шрифта текста флажка.

fsize = cbx.FontSize
fsize =

    12

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

Сохраните следующий код в disableRadioButton.m на вашем пути MATLAB.

Этот код создает окно, содержащее группу переключателей и флажок. Когда пользователь приложения снимает флажок, флажок ValueChangedFcn отключает третий переключатель.

function disableRadioButton
% Create a figure window:
fig = uifigure('Position',[100 100 229 276]);

% Create a button group and radio buttons:
bg = uibuttongroup('Parent',fig,...
    'Position',[56 77 123 85]);
rb1 = uiradiobutton(bg,'Position',[10 60 91 15]);
rb2 = uiradiobutton(bg,'Position',[10 38 91 15]);
rb3 = uiradiobutton(bg,'Position',[10 16 91 15]);

% Create a check box:
cbx = uicheckbox(fig,'Position',[55 217 102 15],...
    'ValueChangedFcn',@(cbx,event) cBoxChanged(cbx,rb3));
end

% Create the function for the ValueChangedFcn callback:
function cBoxChanged(cbx,rb3)
val = cbx.Value;
if val
    rb3.Enable = 'off';
else
    rb3.Enable = 'on';
end
end

Запустите disableRadioButton, и затем установите флажок. Третий переключатель отключен.

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

свернуть все

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

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

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

Пример: 'Значение', 1 указывает, что флажок отображен с галочкой.

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

Состояние флажка, заданного как (FALSE) 0 или (TRUE) 1. Когда Value свойство установлено в 1, флажок проверяется. Когда Value свойство установлено в 0, флажок не проверяется.

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

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

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

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

Этот обратный вызов выполняется, когда пользователь выбирает или снимает флажок в приложении. Обратный вызов не выполняется, если значение флажка изменяется программно.

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

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

СвойствоЗначение
ЗначениеЗначение флажка после нового взаимодействия пользователя приложения с ним.
PreviousValueЗначение флажка перед новым взаимодействием пользователя приложения с ним.
SourceКомпонент, который выполняет обратный вызов.
EventName'ValueChanged'

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

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

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

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

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

Пример: [200 200 102 15]

Введенный в R2016a

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