Exponenta Banner
exponenta event banner

uiradiobutton

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

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

Синтаксис

rb = uiradiobutton
rb = uiradiobutton (родительский)
rb = uiradiobutton (___, имя, значение)

Описание

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 объект. ButtonGroup должен быть родительским для Figure создан с помощью uifigure или к дочернему контейнеру uifigure, например: Tab, Panel, ButtonGroup, или GridLayout.

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

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

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

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

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

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

При программном изменении Value свойство RadioButton кому 0, MATLAB устанавливает 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Расстояние между верхним и нижним наружными краями переключателя

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

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

Совет

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

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

  • Чтобы определить, какой переключатель или переключатель выбран, запросите SelectedObject имущества ButtonGroup. Этот запрос можно выполнить в любом месте кода.

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

См. также

Функции

Свойства

Представлен в R2016a

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

Поддержка