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 функция. App Designer использует этот тип фигуры для того, чтобы создать приложения.

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

f = uifigure;
bg = uibuttongroup(f,'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.

  • Для списка свойств, доступных для GUIDE, или для того, чтобы создать приложения с figure функционируйте, смотрите ButtonGroup Properties для GUIDE.

  • Для списка свойств, доступных для App Designer, или для того, чтобы создать приложения с uifigure функционируйте, смотрите ButtonGroup Properties для App Designer.

Советы

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

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

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

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

Смотрите также

Функции

Свойства

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

Для просмотра документации необходимо авторизоваться на сайте