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

uitable

테이블 사용자 인터페이스 구성요소 생성

구문

uit = uitable

uit = uitable(Name,Value)

uit = uitable(parent)

uit = uitable(parent,Name,Value)

설명

uit = uitable은 현재 Figure에서 테이블 사용자 인터페이스 구성요소를 생성하고 Table UI 구성요소 객체를 반환합니다. 사용할 수 있는 Figure가 없으면 MATLAB^®은 figure 함수를 호출하여 Figure를 만듭니다.

uit = uitable(Name,Value)는 하나 이상의 이름-값 쌍의 인수를 사용하여 테이블 UI 구성요소의 속성값을 지정합니다.

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

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

예제

테이블 배열 데이터 표시하기

R2018a부터는 테이블 UI 구성요소에 table 배열 데이터를 표시할 수 있습니다. 이 데이터형은 테이블 UI 구성요소가 uifigure 함수를 사용하여 만든 Figure 내에 있는 경우에만 지원됩니다. 앱 디자이너는 앱을 만들 때 이 유형의 Figure를 사용합니다.

파일로부터 데이터를 읽어 들이는 readtable 함수를 호출하여 테이블 배열 t를 만듭니다. t에서 변수 4개와 행 15개를 선택합니다.

t = readtable('patients.xls');
vars = {'Age','Systolic','Diastolic','Smoker'};
t = t(1:15,vars);

테이블 UI 구성요소를 만들고 t를 데이터로 지정합니다.

fig = uifigure;
uit = uitable(fig,'Data',t);

정렬된 표시 데이터에 대한 시각화 업데이트하기

R2019a부터는 Data 속성에 table 배열 데이터가 저장된 테이블 UI 구성요소의 열을 정렬할 수 있습니다. 이 데이터형은 테이블 UI 구성요소가 uifigure 함수를 사용하여 만든 Figure 내에 있는 경우에만 지원됩니다. 앱 디자이너는 앱을 만들 때 이 유형의 Figure를 사용합니다.

사용자가 열을 정렬하거나 셀을 편집하면 table 배열 데이터를 표시하고 플롯을 업데이트합니다.

먼저 tsunamisData.m이라는 프로그램 파일을 생성합니다. 프로그램 파일 내에서 다음을 수행합니다.

• readtable 함수를 호출하여 table 배열을 만듭니다.

• Figure에 표시할 정렬 및 편집 가능한 테이블 UI 구성요소를 만듭니다. table 배열을 구성요소의 Data 속성에 저장합니다.

• 사용자가 테이블 UI 구성요소에서 열을 정렬하거나 셀을 편집하면 DisplayData 속성을 사용하여 플롯을 업데이트하는 DisplayDataChangedFcn 콜백을 지정합니다.

function tsunamisData
t = readtable('tsunamis.xlsx');
vars = {'Year','MaxHeight','Latitude','Longitude'};
t = t(1:20,vars);

fig = uifigure;
fig.Position(3:4) = [822 360];

uit = uitable(fig);
uit.Data = t;
uit.ColumnSortable = [false true true true];
uit.ColumnEditable = true;
uit.Position(3) = 375;
uit.DisplayDataChangedFcn = @updatePlot;

ax = uiaxes(fig);
ax.Position(1) = 415;
ax.YLabel.String = 'Max Height';
x = t.Year;
y = t.MaxHeight;
area(ax,x,y)

    function updatePlot(src,event)
        t = uit.DisplayData;
        x = t.Year;
        y = t.MaxHeight;
        area(ax,x,y)
    end

end

정렬 가능한 열 위에 마우스를 올리면 머리글에 화살표가 표시됩니다. 정렬 가능한 열을 찾아서 테이블을 정렬합니다. 정렬 후에 표시되는 데이터와 플롯이 어떻게 업데이트되는지 살펴봅니다.

테이블의 특정 셀에 스타일 추가하기

R2019b부터는 uistyle 함수와 addStyle 함수를 사용하여 테이블 UI 구성요소의 행, 열 또는 셀에 스타일을 적용할 수 있습니다. 테이블 UI 구성요소가 uifigure 함수를 사용하여 만든 Figure 내에 있는 경우에만 스타일이 지원됩니다. 앱 디자이너는 앱을 만들 때 이 유형의 Figure를 사용합니다.

결측값이 포함된 테이블 UI 구성요소에 있는 셀에 스타일을 적용해 보겠습니다. 여기서는 NaN 값이 있는 셀에 노란색 배경색 스타일을 추가합니다.

쓰나미 샘플 데이터를 작업 공간에 테이블 배열로 읽어 옵니다. 그런 다음, 데이터를 표시할 테이블 UI 구성요소를 만듭니다.

tdata = readtable('tsunamis.xlsx');
vars = {'Year','Month','Day','Hour','MaxHeight','Cause','EarthquakeMagnitude'};
tdata = tdata(1:100,vars);

fig = uifigure('Position',[500 500 750 350]);
uit = uitable(fig);
uit.Position = [20 20 710 310];
uit.Data = tdata;
uit.RowName = 'numbered';

ismissing 함수를 사용하여 결측값을 포함한 테이블 요소의 논리형 배열을 가져옵니다. NaN 값이 있는 요소에 대한 행 첨자와 열 첨자를 찾습니다. 마지막으로, 노란색 배경색 스타일을 만들어 테이블 UI 구성요소에서 NaN 값이 있는 셀에 추가합니다.

styleIndices = ismissing(tdata);
[row,col] = find(styleIndices);

s = uistyle('BackgroundColor','yellow');
addStyle(uit,s,'cell',[row,col]);

숫자로 구성된 배열 표시하기

정수형 난수로 구성된 10x3 배열을 표시하는 테이블 UI 구성요소를 만듭니다. Data 속성은 표시할 값을 지정하고, Position 속성은 Figure 내의 테이블 위치와 테이블 크기를 지정합니다.

f = figure;
uit = uitable(f,'Data',randi(100,10,3),'Position',[20 20 262 204]);

여러 데이터형 표시하기

테이블 UI 구성요소에는 데이터형이 서로 다른 열이 포함될 수 있습니다.

빈 Table UI 구성요소를 만듭니다.

f = figure;
uit = uitable(f);

Data 속성을 설정하여 데이터를 여러 데이터형을 포함하는 셀형 배열로 채웁니다. 그런 다음, Position 속성을 설정하여 데이터에 맞게 테이블의 위치와 크기를 조정합니다.

d = {'Male',52,true;'Male',40,true;'Female',25,false};
uit.Data = d;
uit.Position = [20 20 258 78];

ColumnName 속성을 설정하여 열 제목을 좀 더 구체적인 이름으로 변경합니다. 그리고 사용자가 UI에서 데이터를 편집할 수 있도록 ColumnEditable 속성을 true로 설정합니다. 사용자가 UI에서 값을 변경하면 테이블의 Data 속성은 해당 변경 사항을 반영하기 위해 업데이트됩니다.

uit.ColumnName = {'Gender','Age','Authorized'};
uit.ColumnEditable = true;

입력 인수

parent — 부모 컨테이너

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

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

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

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

이름-값 쌍의 인수

예: 'Data',[1 2 3; 4 5 6]

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

이름-값 쌍의 인수를 사용하여 Table 속성을 설정할 수 있습니다.

• uifigure 함수로 생성된 앱 또는 앱 디자이너에서 사용할 수 있는 속성 목록은 Table 속성을 참조하십시오.

• figure 함수로 생성된 앱에서 사용할 수 있는 속성 목록은 Table 속성을 참조하십시오.

참고 항목

함수

• addStyle | removeStyle | uistyle

속성

• Style Properties | Table 속성

도움말 항목

• 앱 디자이너로 만든 앱의 table형 배열 데이터 유형
• 테이블을 표시하는 프로그래밍 방식 앱

R2008a에 개발됨