Exponenta Banner

uitogglebutton

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

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

Синтаксис

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

Описание

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

пример

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

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

Задайте дополнительные разделенные запятой пары Name,Value аргументы. 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

Документация MATLAB
Поддержка