uitab

탭이 있는 패널 만들기

페이지 내 모두 축소

구문

t = uitab
t = uitab(parent)
t = uitab(___,Name,Value)

설명

t = uitab 탭 그룹 내에 탭을 만들고 Tab 객체를 반환합니다. 사용할 수 있는 탭 그룹이 없으면 MATLAB®은 figure 함수를 호출하여 Figure를 만듭니다. 그런 다음 해당 Figure에 탭 그룹을 만들고 탭 그룹 내부에 탭을 배치합니다.

t = uitab(parent)는 지정된 부모 컨테이너에 탭을 만듭니다. 부모 컨테이너는 탭 그룹이어야 합니다. 자세한 내용은 이름-값 인수 항목을 참조하십시오.

t = uitab(___,Name,Value)는 하나 이상의 이름-값 인수로 지정된 속성이 있는 탭을 만듭니다. 예를 들어, Title 속성을 사용하여 탭 제목을 지정합니다. 위에 열거된 구문에 나와 있는 입력 인수를 조합하여 이 옵션과 함께 사용하십시오.

예제

예제

모두 축소

라이브 스크립트 열기

UI Figure에 두 개의 탭으로 구성된 탭 그룹을 만듭니다. 각 탭의 제목을 지정합니다.

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

Figure contains an object of type uitabgroup.

라이브 스크립트 열기

UI Figure에 두 개의 탭으로 구성된 탭 그룹을 만든 다음 속성값을 지정하여 탭의 모양을 사용자 지정합니다.

fig = uifigure;
tg = uitabgroup(fig);
t1 = uitab(tg,"Title","Data","BackgroundColor",[0 0.4470 0.7410]);
t2 = uitab(tg,"Title","Plots","BackgroundColor",[0 0.4470 0.7410]);

Figure contains an object of type uitabgroup.

Data 탭 제목의 텍스트 색을 쿼리합니다.

c = t1.ForegroundColor
c = 1×3

    0.1294    0.1294    0.1294

탭 배경색과 일치하도록 텍스트 색을 업데이트합니다.

t1.ForegroundColor = t1.BackgroundColor;

Figure contains an object of type uitabgroup.

하나의 탭을 포함하는 탭 그룹을 만듭니다. 탭에 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');

UI figure window with a tab group with one tab. The UI components in the tab are partially in view and the tab has no scroll bar.

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

t.Scrollable = 'on';

UI figure window with a tab group with one tab. The tab has a scroll bar that is scrolled to the top.

새 스크립트에서 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

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

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

입력 인수

모두 축소

부모 컨테이너로, TabGroup 객체로 지정됩니다.

이름-값 인수

모두 축소

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

예: uitab(Title="Options")는 탭 제목을 Options로 지정합니다.

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

예: uitab("Title","Options")는 탭 제목을 Options로 지정합니다.

참고

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

제목으로, 문자형 벡터, string형 스칼라 또는 categorical형 배열로 지정됩니다. 이 속성을 categorical형 배열로 지정할 경우 MATLAB은 배열의 첫 번째 요소만 표시합니다.

MATLAB은 세로줄('|') 문자를 줄 바꿈으로 해석하지 않으며, 이를 제목에 세로줄로 표시합니다.

Unicode® 문자를 지정하려면 Unicode 십진수 코드를 char 함수에 전달하십시오. 예를 들어, ['Multiples of ' char(960)]은 Multiples of π로 표시됩니다.

배경색으로, RGB 3색, 16진수 색 코드 또는 표에 나열된 색 옵션 중 하나로 지정됩니다.

RGB 3색과 16진수 색 코드는 사용자 지정 색을 지정할 때 유용합니다.

  • RGB 3색은 요소를 3개 가진 행 벡터로, 각 요소는 색을 구성하는 빨간색, 녹색, 파란색의 농도를 지정합니다. 농도의 범위는 [0,1]이어야 합니다(예: [0.4 0.6 0.7]).

  • 16진수 색 코드는 문자형 벡터 또는 string형 스칼라로, 해시 기호(#)로 시작하고 그 뒤에 3자리 또는 6자리의 16진수 숫자(0에서 F 사이일 수 있음)가 옵니다. 이 값은 대/소문자를 구분하지 않습니다. 따라서 색 코드 "#FF8800", "#ff8800", "#F80" 및 "#f80"은 모두 동일합니다.

몇몇의 흔한 색은 이름으로 지정할 수도 있습니다. 다음 표에는 명명된 색 옵션과 그에 해당하는 RGB 3색 및 16진수 색 코드가 나와 있습니다.

색 이름짧은 이름RGB 3색16진수 색 코드모양
"red""r"[1 0 0]"#FF0000"

Sample of the color red

"green""g"[0 1 0]"#00FF00"

Sample of the color green

"blue""b"[0 0 1]"#0000FF"

Sample of the color blue

"cyan" "c"[0 1 1]"#00FFFF"

Sample of the color cyan

"magenta""m"[1 0 1]"#FF00FF"

Sample of the color magenta

"yellow""y"[1 1 0]"#FFFF00"

Sample of the color yellow

"black""k"[0 0 0]"#000000"

Sample of the color black

"white""w"[1 1 1]"#FFFFFF"

Sample of the color white

다음 표에는 라이트 테마와 다크 테마에서 플롯의 디폴트 색 팔레트가 나열되어 있습니다.

팔레트팔레트 색

"gem" — 라이트 테마 디폴트 값

R2025a 이전: 대부분의 플롯은 기본적으로 이 색을 사용합니다.

Sample of the "gem" color palette

"glow" — 다크 테마 디폴트 값

Sample of the "glow" color palette

orderedcolors 함수와 rgb2hex 함수를 사용하여 이러한 팔레트의 RGB 3색과 16진수 색 코드를 가져올 수 있습니다. 예를 들어, "gem" 팔레트의 RGB 3색을 가져와서 16진수 색 코드로 변환해 보겠습니다.

RGB = orderedcolors("gem");
H = rgb2hex(RGB);

R2023b 이전: RGB = get(groot,"FactoryAxesColorOrder")를 사용하여 RGB 3색을 가져옵니다.

R2024a 이전: H = compose("#%02X%02X%02X",round(RGB*255))를 사용하여 16진수 색 코드를 가져옵니다.

읽기 전용 속성입니다.

탭의 위치와 크기로, 요소를 4개 가진 [left bottom width height] 형식의 벡터로 반환됩니다. 다음 표에서는 벡터의 각 요소를 설명합니다.

요소설명
left탭 그룹의 왼쪽 내부 가장자리부터 탭의 왼쪽 내부 가장자리까지의 거리.
bottom탭 그룹의 맨 아래 내부 가장자리부터 탭의 맨 아래 내부 가장자리까지의 거리.
width탭의 오른쪽과 왼쪽 내부 가장자리 사이의 거리.
height탭의 상단과 하단 내부 가장자리 사이의 거리.

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

참고

다음은 Position 속성을 사용할 때 고려해야 할 일부 중요 사항입니다.

  • Position 값은 부모 TabGroup 객체의 탭 제목 길이와 TabLocation 속성으로부터 영향을 받습니다.

  • Position 값은 부모 TabGroup의 경계 내부 영역인 그리기 가능 영역을 기준으로 합니다.

  • 탭이 그리드 레이아웃 관리자에 있는 경우에는 Position 속성의 값이 즉시 업데이트되지 않습니다. Position 값을 사용하여 탭 크기를 기준으로 탭 자식의 크기를 조정하려면 SizeChangedFcn 콜백을 사용하십시오.

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

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

Windows® 및 Macintosh 시스템에서 1픽셀의 크기는 1/96인치입니다. 이 크기는 시스템 해상도와 관계가 없습니다.

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에 개발됨

모두 확장

참고 항목

함수

속성