exponenta event banner

uibuttongroup

Создание группы кнопок для управления переключателями и переключателями

Описание

bg = uibuttongroup создает группу кнопок на текущем рисунке и возвращает ButtonGroup объект. Если рисунок недоступен, MATLAB ® вызывает figure для создания функции.

пример

bg = uibuttongroup(Name,Value) указывает значения свойств группы кнопок, используя один или несколько аргументов пары имя-значение.

bg = uibuttongroup(parent) создает группу кнопок в указанном родительском контейнере. Родительский контейнер может быть фигурой, созданной с помощью figure или uifigure функцию или дочерний контейнер, например панель. Значения свойств для uibuttongroup незначительно различаются в зависимости от того, создано ли приложение с помощью figure или uifigure функция. Дополнительные сведения см. в разделе Аргументы пары «имя-значение».

пример

bg = uibuttongroup(parent,Name,Value) задает родительский контейнер и одно или несколько значений свойств.

Примеры

свернуть все

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

Скопируйте и вставьте этот код в редактор и запустите его, чтобы увидеть, как он работает.

function myui
bg = uibuttongroup('Visible','off',...
                  'Position',[0 0 .2 1],...
                  'SelectionChangedFcn',@bselection);
              
% Create three radio buttons in the button group.
r1 = uicontrol(bg,'Style',...
                  'radiobutton',...
                  'String','Option 1',...
                  'Position',[10 350 100 30],...
                  'HandleVisibility','off');
              
r2 = uicontrol(bg,'Style','radiobutton',...
                  'String','Option 2',...
                  'Position',[10 250 100 30],...
                  'HandleVisibility','off');

r3 = uicontrol(bg,'Style','radiobutton',...
                  'String','Option 3',...
                  'Position',[10 150 100 30],...
                  'HandleVisibility','off');
              
% Make the uibuttongroup visible after creating child objects. 
bg.Visible = 'on';

    function bselection(source,event)
       disp(['Previous: ' event.OldValue.String]);
       disp(['Current: ' event.NewValue.String]);
       disp('------------------');
    end
end

bselection функция отображает OldValue и NewValue свойства event.

Scrollable позволяет выполнять прокрутку внутри группы кнопок, имеющей компоненты за пределами ее границ. Прокрутка возможна только в том случае, если группа кнопок находится на рисунке, созданном с помощью uifigure функция. Конструктор приложений использует этот тип фигур для создания приложений.

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

fig = uifigure;
bg = uibuttongroup(fig,'Position',[20 20 196 135]);
tb1 = uitogglebutton(bg,'Position',[11 165 140 22],'Text','One');
tb2 = uitogglebutton(bg,'Position',[11 140 140 22],'Text','Two');
tb3 = uitogglebutton(bg,'Position',[11 115 140 22],'Text','Three');
tb4 = uitogglebutton(bg,'Position',[11 90 140 22],'Text','Four');
tb5 = uitogglebutton(bg,'Position',[11 65 140 22],'Text','Five');
tb6 = uitogglebutton(bg,'Position',[11 40 140 22],'Text','Six');

Включить прокрутку, установив Scrollable свойства группы кнопок для 'on'. По умолчанию вверху отображается окно прокрутки.

bg.Scrollable = 'on';

Входные аргументы

свернуть все

Родительский контейнер, указанный как фигура, созданная с помощью figure или uifigure функция или дочерний контейнер:

  • Панели, вкладки и группы кнопок могут быть контейнерами любого типа рисунка.

  • Форматы сетки могут быть контейнерами только в фигурах, созданных с помощью uifigure функция.

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

Пример: 'Title','Options' указывает, что заголовком группы кнопок является Options.

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

  • Список свойств, доступных для приложений, созданных с помощью uifigure функцию или в App Designer см. в разделе Свойства ButityGroup.

  • Список свойств, доступных для приложений, созданных с помощью figure см. раздел Свойства ButureGroup.

Совет

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

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

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

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

См. также

Функции

Свойства

Представлен до R2006a