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

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

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

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

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, см. ButtonGroup Properties.

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

Совет

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

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

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

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

См. также

Функции

Свойства

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