Exponenta Banner

uiradiobutton

Создайте компонент переключателя

Свернуть все на странице

Синтаксис

rb = uiradiobutton
rb = uiradiobutton(parent)
rb = uiradiobutton(___,Name,Value)

Описание

rb = uiradiobutton создает переключатель в группе кнопок и возвращает RadioButton объект. MATLAB® вызывает uifigure функция для создания родительского рисунка для группы кнопок.

rb = uiradiobutton(parent) создает переключатель в указанной группе кнопок. Группа кнопок должна быть дочерним элементом Figure созданный с помощью uifigure функция, или должна быть записана в дочерний контейнер рисунка: Tab, Panel, ButtonGroup, или GridLayout.

пример

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

Примеры

свернуть все

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

fig = uifigure('Position',[680 678 398 271]);
bg = uibuttongroup(fig,'Position',[137 113 123 85]);

Создайте три RadioButton Объектами и укажите родительский элемент и местоположение каждого.

rb1 = uiradiobutton(bg,'Position',[10 60 91 15]);
rb2 = uiradiobutton(bg,'Position',[10 38 91 15]);
rb3 = uiradiobutton(bg,'Position',[10 16 91 15]);

Изменение текста, связанного с каждым переключателем.

rb1.Text = 'English';
rb2.Text = 'French';
rb3.Text = 'German';

Установите переключатель на немецкий язык.

rb3.Value = true;

Определите название шрифта текста переключателя на немецком языке.

font = rb3.FontName
font =

Helvetica

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

свернуть все

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

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

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

Пример: 'Text', 'French' указывает, что рядом с переключателем отображается текст «Французский».

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

Состояние переключателя, заданное как 1 (true) или 0 (false). В группе кнопок одновременно можно выбрать только одну кнопку. Состояние первого переключателя, добавленного в группу кнопок 1, по умолчанию. Последующие кнопки, добавленные в ту же группу кнопок, имеют состояние по умолчанию 0.

Когда Value свойство RadioButton изменения в 1, а Value свойства для ранее выбранных RadioButton изменения в 0. В сложение, SelectedObject значение свойства родительского ButtonGroup обновляется.

Если вы программно меняете Value свойство RadioButton на 0MATLAB устанавливает Value свойство первого RadioButton добавлено к ButtonGroup на 1. Если первый RadioButton добавлен тот, для которого вы программно установите Value свойство к 0, затем MATLAB устанавливает Value свойство для второго RadioButton добавлено к ButtonGroup на 1.

Примечание

Первый RadioButton добавлен в ButtonGroup не обязательно первый RadioButton перечислены в Children свойство ButtonGroup.

Метка кнопки, заданная как вектор символов, массив ячеек из векторов символов, строкового скаляра, строковых массивов или 1-D категориального массива. Задайте вектор символов или строковый скаляр, чтобы пометить кнопку одной линией текста. Используйте массив ячеек или строковые массивы, чтобы пометить кнопку несколькими линиями текста. Каждый элемент массива представляет отдельную линию текста. Если вы задаете это свойство как категориальный массив, MATLAB использует значения в массиве, а не полный набор категорий.

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

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

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

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

Совет

  • Группы кнопок могут содержать любой тип компонента пользовательского интерфейса, но могут управлять только выбором переключателей и кнопок-переключателей.

  • Чтобы программа отвечала, когда пользователь выбирает переключатель или кнопку-переключатель, находящийся внутри группы кнопок, задайте SelectionChangedFcn функция обратного вызова для ButtonGroup. Вы не можете задать коллбэки для отдельных кнопок.

  • Чтобы определить, какой переключатель или кнопка-переключатель выбран, запросите SelectedObject свойство ButtonGroup. Вы можете выполнить этот запрос в любом месте вашего кода.

  • Если вы задаете Visible свойство объекта группы кнопок, для 'off'и все содержащиеся в нем дочерние объекты становятся невидимыми вместе с родительским элементом ButtonGroup. Однако Visible значение свойства каждого дочернего объекта остается неизменным.

См. также

Функции

Свойства

Введенный в R2016a

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

Поддержка