Exponenta Banner
exponenta event banner

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

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

Задайте необязательные разделенные разделенными запятой парами Name,Value аргументы. Name - имя аргумента и Value - соответствующее значение. Name должны находиться внутри кавычек. Можно задать несколько аргументов в виде пар имен и значений в любом порядке Name1,Value1,...,NameN,ValueN.

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

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

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

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

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

Примечание

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

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

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

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

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

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

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

Пример: 'C:\Documents\icon.png' задает полный путь к файлу изображения.

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

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

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

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

Совет

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

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

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

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

См. также

Функции

Свойства

Введенный в R2016a

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

Поддержка