이 페이지의 최신 내용은 아직 번역되지 않았습니다. 최신 내용은 영문으로 볼 수 있습니다.

uibuttongroup

버튼 그룹을 만들어 라디오 버튼과 토글 버튼 관리

구문

bg = uibuttongroup

bg = uibuttongroup(Name,Value)

bg = uibuttongroup(parent)

bg = uibuttongroup(parent,Name,Value)

설명

bg = uibuttongroup은 현재 Figure에 버튼 그룹을 만들고 ButtonGroup 객체를 반환합니다. 사용할 수 있는 Figure가 없으면 MATLAB^®은 figure 함수를 호출하여 Figure를 만듭니다.

bg = uibuttongroup(Name,Value)는 하나 이상의 이름-값 쌍의 인수를 사용하여 버튼 그룹 속성값을 지정합니다.

bg = uibuttongroup(parent)는 지정된 부모 컨테이너에 버튼 그룹을 만듭니다. 부모 컨테이너는 figure 또는 uifigure 함수를 사용하여 만든 Figure이거나 패널과 같은 자식 컨테이너일 수 있습니다. 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 함수는 event의 OldValue 속성과 NewValue 속성을 표시합니다.

스크롤 가능한 버튼 그룹

Scrollable 속성은 테두리 바깥에 구성요소가 있는 버튼 그룹 내에서 스크롤이 가능하도록 합니다. 버튼 그룹이 uifigure 함수를 사용하여 만든 Figure 내에 있는 경우에만 스크롤이 가능합니다. 앱 디자이너는 앱을 만들 때 이 유형의 Figure를 사용합니다.

Figure 내에 버튼 그룹을 만듭니다. 토글 버튼 6개를 추가합니다. 처음 3개는 버튼 그룹 위쪽 테두리 바깥에 놓입니다.

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';

입력 인수

parent — 부모 컨테이너

Figure 객체 (디폴트 값) | Panel 객체 | Tab 객체 | ButtonGroup 객체 | GridLayout 객체

부모 컨테이너로, figure 또는 uifigure 함수를 사용하여 만든 Figure나 다음과 같은 자식 컨테이너로 지정됩니다.

• 패널, 탭 및 버튼 그룹은 위 두 유형의 Figure에서 모두 컨테이너가 될 수 있습니다.

• 그리드 레이아웃은 uifigure 함수를 사용하여 만든 Figure에서만 컨테이너가 될 수 있습니다.

이름-값 쌍의 인수

예: 'Title','Options'는 버튼 그룹 제목을 Options로 지정합니다.

선택적으로 Name,Value 인수가 쉼표로 구분되어 지정됩니다. 여기서 Name은 인수 이름이고 Value는 대응값입니다. Name은 작은따옴표(' ') 안에 표시해야 합니다. Name1,Value1,...,NameN,ValueN과 같이 여러 개의 이름-값 쌍의 인수를 지정할 수 있습니다.

• GUIDE에 사용할 수 있는 속성 목록을 보거나 figure 함수로 앱을 만들 경우, GUIDE에 대한 ButtonGroup Properties을 참조하십시오.

• 앱 디자이너에 사용할 수 있는 속성 목록을 보거나 uifigure 함수로 앱을 만들 경우, 앱 디자이너에 대한 ButtonGroup Properties을 참조하십시오.

팁

• 버튼 그룹은 모든 UI 구성요소 유형을 포함할 수 있지만, 라디오 버튼과 토글 버튼의 선택 항목만 관리합니다.

• 앱 사용자가 버튼 그룹 내에 있는 라디오 버튼이나 토글 버튼을 선택할 때 프로그램이 응답하도록 하려면 버튼 그룹에 대한 SelectionChangedFcn 콜백 함수를 정의하십시오. 개별 버튼에 대해서는 콜백을 정의할 수 없습니다.

• 어떤 라디오 버튼이나 토글 버튼이 선택되었는지 확인하려면 버튼 그룹의 SelectedObject 속성을 쿼리하십시오. 사용자의 코드 어디에서나 이 쿼리를 실행할 수 있습니다.

• button group 객체의 Visible 속성을 'off'로 설정하면 이 객체에 포함되는 하위 객체(버튼, 기타 버튼 그룹 등)는 부모 버튼 그룹과 함께 보이지 않게 됩니다. 그러나, 각 자식 객체의 Visible 속성값은 영향을 받지 않습니다.

참고 항목

함수

• uicontrol | uipanel | uiradiobutton | uitogglebutton

속성

• ButtonGroup Properties

R2006a 이전에 개발됨