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 использует значения в массиве, не полный набор категорий.

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

Поддерживаемые форматы изображения включают JPEG, PNG, GIF, SVG или m- n- 3 матрицы изображений истинного цвета. Для получения дополнительной информации о матрицах изображений истинного цвета, смотрите Типы изображения.

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

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

Пример: 'icon.png' задает файл значка на пути MATLAB.

Пример: '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
Поддержка