uitogglebutton

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

Синтаксис

tb = uitogglebutton
tb = uitogglebutton(parent)
tb = uitogglebutton(___,Name,Value)

Описание

tb = uitogglebutton создает кнопку-переключатель в группе кнопок и возвращает объект ToggleButton. MATLAB® вызывает функцию uifigure, чтобы создать родительскую фигуру группы кнопок.

пример

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

пример

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

Примеры

свернуть все

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

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

Создайте три кнопки-переключателя и задайте местоположение каждого.

tb1 = uitogglebutton(bg,'Position',[10 50 100 22]);
tb2 = uitogglebutton(bg,'Position',[10 28 100 22]);
tb3 = uitogglebutton(bg,'Position',[10 6 100 22]);

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

tb1.Text = 'English';
tb2.Text = 'French';
tb3.Text = 'German';

Измените выбор кнопки-переключателя на немецкий язык программно.

tb3.Value = true;

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

font = tb3.FontName
font =

Helvetica

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

свернуть все

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

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

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

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

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

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

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

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

Примечание

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

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

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

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

Тип файла изображения должен быть JPEG, GIF или PNG.

  • Если текст кнопки занимает все место, заданное значением свойства Position, то MATLAB не отображает значок.

  • Если некоторая комната доступна для значка, то MATLAB уменьшает масштаб изображения, чтобы соответствовать при необходимости.

Пример: 'icon.png'

Пример: 'C:\Documents\icon.png'

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

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

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

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

Советы

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

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

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

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

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

Функции

Свойства

Введенный в R2016a

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