uibuttongroup

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

свернуть все на странице

Синтаксис

bg = uibuttongroup
bg = uibuttongroup(Name,Value)
bg = uibuttongroup(parent)
bg = uibuttongroup(parent,Name,Value)

Описание

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

пример

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

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

пример

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) — соответствующее значение. Имя должно находиться внутри одинарных кавычек (' '). Можно задать несколько имен и аргументов пары значения как Name1,Value1,...,NameN,ValueN.

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

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

Советы

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

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

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

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

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

Функции

Свойства

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

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