uiradiobutton

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

Описание

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

rb = uiradiobutton(parent) создает переключатель в заданной группе кнопок. Группа кнопок должна быть дочерним элементом Figure созданный с uifigure функция, или должен быть порожден к дочернему контейнеру фигуры: TabПанельГруппа кнопок, или 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ПанельГруппа кнопок, или GridLayout.

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

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

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

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

Состояние переключателя, заданного как 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.

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

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

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

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

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

Советы

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

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

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

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

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

Функции

Свойства

Введенный в R2016a