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

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

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

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

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

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

Для просмотра документации необходимо авторизоваться на сайте