Exponenta Banner

uiradiobutton

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

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

Синтаксис

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

Описание

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 функция, или к дочернему контейнеру a 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

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

Поддержка