Main Content

uitabgroup

탭이 있는 패널에 대한 컨테이너 만들기

설명

tg = uitabgroup은 현재 Figure에 탭 그룹을 만들고 TabGroup 객체를 반환합니다. 사용할 수 있는 Figure가 없으면 MATLAB®figure 함수를 호출하여 Figure를 만듭니다. 탭 그룹은 탭에 대한 컨테이너입니다. 이를 통해 선택한 탭을 식별하고 사용자가 다른 탭을 선택할 경우 감지할 수 있습니다.

tg = uitabgroup(Name,Value)는 하나 이상의 이름-값 인수를 사용하여 탭 그룹 속성값을 지정합니다. 예를 들어, 탭 그룹의 위치나 탭 레이블의 위치를 지정할 수 있습니다.

tg = uitabgroup(parent)는 지정된 부모 컨테이너에 탭 그룹을 만듭니다. 부모 컨테이너는 figure 또는 uifigure 함수를 사용하여 만든 Figure이거나 패널과 같은 자식 컨테이너일 수 있습니다. uitabgroup의 속성값은 앱을 figure 함수로 만들었는지 아니면 uifigure 함수로 만들었는지에 따라 약간 달라집니다. 자세한 내용은 이름-값 인수 항목을 참조하십시오.

예제

tg = uitabgroup(parent,Name,Value)는 부모 컨테이너와 하나 이상의 속성값을 지정합니다.

예제

모두 축소

탭 그룹과 두 개의 탭을 포함하는 Figure를 만듭니다.

f = figure;
tabgp = uitabgroup(f,"Position",[.05 .05 .3 .8]);
tab1 = uitab(tabgp,"Title","Settings");
tab2 = uitab(tabgp,"Title","Options");

Tab group with two tabs in a figure window. The tabs have titles "Settings" and "Options". The "Settings" tab is selected.

현재 선택한 탭을 가져옵니다.

currenttab = tabgp.SelectedTab
currenttab = 

  Tab (Settings) with properties:

              Title: 'Settings'
    BackgroundColor: [0.9400 0.9400 0.9400]
           Position: [0.0119 0.0089 0.9702 0.9107]
              Units: 'normalized'

Scrollable 속성은 테두리 바깥에 컴포넌트가 있는 탭 내에서 스크롤이 가능하도록 합니다. 스크롤을 사용하려면 Figure를 uifigure 함수로 작성해야 합니다. 앱 디자이너는 앱을 만들 때 이 유형의 Figure를 사용합니다.

하나의 탭을 포함하는 탭 그룹을 만듭니다. 탭에 UI 컴포넌트 6개를 추가합니다. 처음 3개는 탭의 위쪽 테두리 바깥에 놓입니다.

fig = uifigure;
tg = uitabgroup(fig,"Position",[20 20 196 145]);
t = uitab(tg,"Title","Member Information");
ef1 = uieditfield(t,"Text","Position",[11 165 140 22],"Value","First Name");
ef2 = uieditfield(t,"Text","Position",[11 140 140 22],"Value","Last Name");
ef3 = uieditfield(t,"Text","Position",[11 115 140 22],"Value","Address");
dd = uidropdown(t,"Position",[11 90 140 22],"Items",{'Male','Female'});
cb = uicheckbox(t,"Position",[11 65 140 22],"Text","Member");
b = uibutton(t,"Position",[11 40 140 22],"Text","Send");

Tab group with one tab labeled "Member Information" in a UI figure window. Only the UI components at the bottom of the tab (the drop-down list, check box, and button) are visible.

탭의 Scrollable 속성을 "on"으로 설정하여 스크롤을 활성화합니다. 기본적으로 스크롤 바는 상단에 표시됩니다.

t.Scrollable = "on";

Tab group with one tab labeled "Member Information" in a UI figure window. Only the components at the top (the edit fields, drop-down list, and check box) are visible. The tab has a vertical scroll bar.

새 스크립트에서 UI Figure에 두 개의 탭으로 구성된 탭 그룹을 만듭니다. SelectionChangedFcn 속성을 displaySelection이라는 함수에 대한 핸들로 지정합니다. 이 함수는 사용자가 탭 그룹에 있는 탭 간에 전환할 때 실행됩니다.

스크립트의 아래쪽에, MATLAB이 콜백 함수에 전달하는 다음 두 개의 입력 인수를 받도록 displaySelection 함수를 정의합니다.

  • src — 콜백을 실행한 컴포넌트

  • event — 콜백을 트리거한 사용자 상호 작용에 대한 정보

콜백 함수에서, 현재 보이는 탭의 제목을 명령 창에 표시하는 코드를 작성합니다.

fig = uifigure;
tg = uitabgroup(fig,"SelectionChangedFcn",@displaySelection);
t1 = uitab(tg,"Title","Data");
t2 = uitab(tg,"Title","Plots");

function displaySelection(src,event)
    t = event.NewValue;
    title = t.Title;
    disp("Viewing the " + title + " tab")
end

스크립트를 실행하고 탭 간에 전환하여 탭 제목을 표시합니다.

자세한 내용은 프로그래밍 방식으로 만든 앱에 대한 콜백 만들기 항목을 참조하십시오.

입력 인수

모두 축소

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

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

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

이름-값 인수

선택적 인수 쌍을 Name1=Value1,...,NameN=ValueN으로 지정합니다. 여기서 Name은 인수 이름이고 Value는 대응값입니다. 이름-값 인수는 다른 인수 뒤에 와야 하지만, 인수 쌍의 순서는 상관없습니다.

예: uitabgroup(TabLocation='bottom')은 탭 레이블이 탭 그룹의 맨 아래에 있도록 지정합니다.

R2021a 이전 릴리스에서는 쉼표를 사용하여 각 이름과 값을 구분하고 Name을 따옴표로 묶으십시오.

예: uitabgroup("TabLocation","bottom")은 탭 레이블이 탭 그룹의 맨 아래에 있도록 지정합니다.

참고

여기에 나와 있는 속성은 사용 가능한 속성의 일부에 불과합니다. 전체 목록을 보려면 TabGroup Properties 항목을 참조하십시오.

현재 선택한 탭으로, Tab 객체로 지정됩니다. 이 속성을 사용하여 탭 그룹 내에서 현재 선택된 탭을 파악합니다. 이 속성을 사용하여 디폴트 탭 선택을 설정할 수도 있습니다. SelectedTab 속성의 디폴트 값은 TabGroup에 추가하는 첫 번째 Tab입니다.

선택 변경 콜백으로, 다음 값 중 하나로 지정됩니다.

  • 함수 핸들.

  • 첫 번째 요소가 함수 핸들인 셀형 배열. 이 셀형 배열의 그 다음 요소들은 콜백 함수로 전달할 인수입니다.

  • 유효한 MATLAB 표현식이 포함된 문자형 벡터(권장되지 않음). MATLAB은 이 표현식을 기본 작업 공간에서 실행합니다.

이 콜백 함수는 사용자가 탭 그룹 내에서 다른 탭을 선택할 경우 실행됩니다.

이 콜백 함수는 사용자와 탭의 상호 작용에 대한 특정 정보에 액세스할 수 있습니다. MATLAB은 이 정보를 콜백 함수에 대한 두 번째 인수로서 SelectionChangedData 객체에 전달합니다. 앱 디자이너에서는 이 인수를 event라고 부릅니다. 점 표기법을 사용하여 객체 속성을 쿼리할 수 있습니다. 예를 들어, event.NewValue는 현재 선택된 탭을 반환합니다. SelectionChangedData 객체는 문자형 벡터로 지정된 콜백 함수에 사용할 수 없습니다.

다음 표에는 SelectionChangedData 객체의 속성 목록이 나열되어 있습니다.

속성

설명

OldValue

이전에 선택된 Tab 또는 아무것도 선택되지 않은 경우 []

NewValue

현재 선택한 Tab

Source

콜백을 실행하는 컴포넌트

EventName

'SelectionChanged'

콜백을 작성하는 방법에 대한 자세한 내용은 앱 디자이너에서 콜백 사용하기 항목을 참조하십시오.

탭 레이블 위치로, 'top', 'bottom', 'left' 또는 'right'으로 지정됩니다. 이 속성은 탭 그룹에 대한 탭 레이블의 위치를 지정합니다.

탭 그룹의 위치와 크기로, 요소를 4개 가진 [left bottom width height] 형식의 벡터로 지정됩니다.

다음 표에서는 벡터의 각 요소를 설명합니다.

요소설명
left부모 컨테이너의 왼쪽 내부 가장자리와 탭 그룹의 왼쪽 외부 가장자리 사이의 거리
bottom부모 컨테이너의 내부 하단 가장자리와 탭 그룹의 외부 하단 가장자리 사이의 거리
width탭 그룹의 오른쪽과 왼쪽 외부 가장자리 사이의 거리
height탭 그룹의 상단과 하단 외부 가장자리 사이의 거리

모든 측정값은 Units 속성으로 지정된 단위로 표시됩니다.

Position 값은 부모 컨테이너의 그리기 가능 영역을 기준으로 합니다. 그리기 가능 영역은 컨테이너의 경계 내부 영역이며 장식(예: 메뉴 모음, 제목)이 차지하는 영역은 포함되지 않습니다.

측정 단위로, 다음 표에 있는 값 중 하나로 지정됩니다.

단위 값설명
'pixels'(uifigure 기반 앱의 디폴트 값)

Windows®Macintosh 시스템에서 거리(단위: 픽셀)는 시스템 해상도와 관계가 없습니다. 즉, 다음과 같습니다.

  • Windows 시스템에서 1픽셀은 1/96인치입니다.

  • Macintosh 시스템에서 1픽셀은 1/72인치입니다.

Linux® 시스템에서 픽셀 크기는 시스템 해상도에 의해 결정됩니다.

'normalized'(figure 기반 앱의 디폴트 값)

이 단위는 부모 컨테이너에 대해 정규화됩니다. 컨테이너의 왼쪽 아래 코너는 (0,0)에 매핑되고 오른쪽 위 코너는 (1,1)에 매핑됩니다.

'inches'인치.
'centimeters'센티미터.
'points'포인트. 1포인트는 1/72인치와 같습니다(1인치 = 2.54cm).
'characters'

이 단위는 다음과 같이 그래픽스 root 객체의 디폴트 uicontrol 글꼴을 기반으로 합니다.

  • 문자 너비 = 문자 x의 너비.

  • 문자 높이 = 텍스트의 두 줄의 기준선 간 거리.

디폴트 uicontrol 글꼴에 액세스하려면 get(groot,'defaultuicontrolFontName')이나 set(groot,'defaultuicontrolFontName')을 사용하십시오.

대부분의 MATLAB 앱 작성 기능은 거리를 픽셀 단위로 측정하므로, 권장되는 값은 'pixels'입니다. uigridlayout 함수를 사용하여 생성된 그리드 레이아웃 관리자를 객체의 부모로 지정함으로써 부모 컨테이너의 크기에 따라 다시 스케일링되는 객체를 만들 수 있습니다. 자세한 내용은 Lay Out Apps Programmatically 항목을 참조하십시오.

버전 내역

R2014b에 개발됨

참고 항목

함수

속성