Exponenta Banner
exponenta event banner

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 - имя аргумента и Value - соответствующее значение. Name должны находиться внутри кавычек. Можно задать несколько аргументов в виде пар имен и значений в любом порядке Name1,Value1,...,NameN,ValueN.

Пример: 'Value',1 указывает, что флажок отображается с помощью флажка.

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

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

Значение изменило коллбэк, заданное как одно из следующих значений:

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

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

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

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

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

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

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

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

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

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

The Position значения относятся к drawable area родительского контейнера. Область векторной и растровой графики является областью внутри границ контейнера и не включает область, занимаемую украшениями, такими как панель меню или заголовок.

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

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

См. также

Функции

Свойства

Введенный в R2016a

Документация MATLAB

Поддержка