uicheckbox

Создайте компонент флажка

Синтаксис

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Функции

Свойства

Введенный в R2016a

Для просмотра документации необходимо авторизоваться на сайте