Main Content

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

A table with four columns: "Age", "Systolic", "Diastolic", and "Smoker". The table is populated with data. The data in the "Smoker" column appears as checked or unchecked boxes.

테이블 UI 구성요소에서 table 배열 데이터를 표시하고 프로그래밍 방식으로 업데이트합니다. (이 데이터형은 테이블 UI 구성요소가 uifigure 함수를 사용하여 만든 Figure 내에 있는 경우에만 지원됩니다. 앱 디자이너는 앱을 만들 때 이 유형의 Figure를 사용합니다.)

파일에서 쓰나미 데이터를 읽어 들여 테이블 배열을 만들고 테이블 UI 구성요소에 데이터의 서브셋을 표시합니다.

t = readtable('tsunamis.xlsx');
vars = {'Year','MaxHeight','Validity'};
t = t(1:20,vars);
fig = uifigure;
uit = uitable(fig,'Data',t);

A table with three columns of tsunami data: the year of the tsunami, the maximum tsunami height in meters, and the validity of the tsunami (for example, "questionable tsunami" or "definite tsunami").

UI 테이블의 Data 속성을 편집하여 첫 번째 행에서 쓰나미의 유효성을 업데이트합니다.

uit.Data.Validity(1) = {'definite tsunami'};

A table with tsunami year, maximum height, and validity. The entry in the first row has a Validity value of "definite tsunami".

MaxHeight 열의 데이터에 액세스하고 이를 수정하여 최대 높이 데이터를 미터에서 피트로 변환합니다.

uit.Data.MaxHeight = uit.Data.MaxHeight*3.281;

A table with tsunami year, max height, and validity. The values in the MaxHeight column are in feet.

사용자가 테이블 데이터를 정렬 및 편집할 수 있고 데이터가 변경될 때 데이터 시각화를 업데이트하는 앱을 만듭니다. (대화형 열 정렬은 테이블 UI 구성요소가 uifigure 함수로 생성된 Figure에 있는 경우에만 지원됩니다. 앱 디자이너는 앱을 만들 때 이 유형의 Figure를 사용합니다.)

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

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

  • UI Figure를 생성합니다.

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

  • 거품 차트를 만들어 쓰나미 데이터를 시각화합니다. 여기서 거품의 좌표는 쓰나미의 위도와 경도를 나타내고 거품의 크기는 최대 높이를 나타냅니다.

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

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

    % Create UI figure
    fig = uifigure;
    fig.Position(3:4) = [722 360];

    % Create table UI component
    uit = uitable(fig);
    uit.Data = t;
    uit.ColumnSortable = true;
    uit.ColumnEditable = [false false true];
    uit.Position(3) = 290;
    uit.DisplayDataChangedFcn = @updatePlot;

    % Create bubble chart
    ax = uiaxes(fig);
    ax.Position(1) = 315;
    ax.XLabel.String = 'Longitude';
    ax.YLabel.String = 'Latitude';
    x = t.Longitude;
    y = t.Latitude;
    sz = t.MaxHeight;
    bubblechart(ax,x,y,sz)

        % Update the bubble chart when table data changes
        function updatePlot(src,event)
            t = uit.DisplayData;
            x = t.Longitude;
            y = t.Latitude;
            sz = t.MaxHeight;
            bubblechart(ax,x,y,sz)
        end

end

An app with a table displaying the Latitude, Longitude, and MaxHeight data for a number of tsunamis, and a bubble chart of the table data. The bubble chart plots the location of the tsunamis with Longitude on the x-axis, Latitude on the y-axis, and bubble size given by MaxHeight.

정렬 가능한 열 위에 마우스를 올리면 제목에 화살표가 표시됩니다. 쓰나미의 최대 높이를 기준으로 테이블을 정렬합니다.

The MaxHeight column of the tsunami data table is sorted in ascending order. The user's mouse cursor is on the MaxHeight column header, where an arrow pointing up is displayed next to the header text.

먼저 테이블 셀을 두 번 클릭한 다음 새 높이를 입력하여 두 번째 행의 쓰나미 최대 높이를 30미터로 편집합니다. 거품 차트가 이에 따라 어떻게 업데이트되는지 확인합니다.

The cell in the second row and the MaxHeight column is selected, and the number 1 has been replaced with the number 30. The bubble chart bubble sizes have changed to reflect the new MaxHeight data.

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 760 360]);
uit = uitable(fig);
uit.Position = [20 20 720 320];
uit.Data = tdata;
uit.RowName = 'numbered';

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

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

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

Table with earthquake data. The cells with NaN are highlighted in red.

R2021b부터는 어떤 테이블 요소가 선택될지를 프로그래밍적으로 설정하거나 쿼리할 수 있고, 사용자가 셀, 열 또는 행을 선택할 수 있는지 여부를 지정할 수 있습니다. (테이블 UI 구성요소가 uifigure 함수를 사용하여 만든 Figure 내에 있는 경우에만 프로그래밍 방식 선택이 지원됩니다. 앱 디자이너는 앱을 만들 때 이 유형의 Figure를 사용합니다.)

이 기능을 사용하여 사용자가 테이블에서 데이터를 선택했을 때 데이터가 자동으로 맵에 그려지는 앱을 만듭니다. 먼저 selectTsunamis.m이라는 프로그램 파일을 생성합니다. 프로그램 파일 내에서 다음을 수행합니다.

  • readtable 함수를 호출하여 쓰나미 데이터를 불러옵니다.

  • 테이블 UI 구성요소와 창의 거품 지리 차트로 UI Figure를 생성합니다.

  • 테이블 UI 구성요소를 구성합니다. 쓰나미 데이터를 Data 속성에 저장하고, SelectionType 및 MultiSelect 속성을 설정하여 사용자가 여러 행을 선택할 수 있게 합니다.

  • 앱 사용자가 테이블 선택을 변경하면 거품 차트를 업데이트하는 SelectionChangedFcn 콜백을 지정합니다. 함수가 선택된 행에 대한 거품을 플로팅합니다. 이 때 거품의 크기는 최대 쓰나미 높이를 나타냅니다.

function selectTsunamis
% Load data
T = readtable('tsunamis.xlsx');
vars = {'Latitude','Longitude','MaxHeight'};
T = T(1:20,vars);

% Create UI components
fig = uifigure('Position',[500 500 700 350]);
tbl = uitable(fig,'Position',[20 20 250 300]);
pnl = uipanel(fig,'Position',[285 20 400 300]);
geobubble(pnl,[],[]);

% Configure table
tbl.Data = T;
tbl.SelectionType = 'row';
tbl.Multiselect = 'on';
tbl.SelectionChangedFcn = @plotTsunami;

  % Plot tsunami data for each selected row
  function plotTsunami(src,event)
    rows = event.Selection;
    data = src.Data(rows,:);
    lat = data.Latitude;
    long = data.Longitude;
    ht = data.MaxHeight;
    geobubble(pnl,lat,long,ht);
  end
end

selectTsunamis 함수를 실행하고 Ctrl 키를 누른 채 클릭하여 여러 개의 테이블 행을 선택합니다. 플롯이 쓰나미 데이터로 업데이트됩니다.

Figure window with a table and a geographic bubble chart. Multiple table rows are selected.

R2021a부터는 scroll 함수를 사용하여 프로그래밍 방식으로 테이블 UI 구성요소의 행, 열 또는 셀로 스크롤할 수 있습니다. (테이블 UI 구성요소가 uifigure 함수를 사용하여 만든 Figure 내에 있는 경우에만 프로그래밍 방식 스크롤이 지원됩니다. 앱 디자이너는 앱을 만들 때 이 유형의 Figure를 사용합니다.)

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

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

fig = uifigure;
uit = uitable(fig,'Data',tdata);
uit.RowName = 'numbered';

Table with patient data in a UI figure window. The table rows are numbered, and the table is scrolled to the top.

테이블의 25번째 행으로 스크롤합니다. 

scroll(uit,'row',25)

Table with patient data in a UI figure window. The table is scrolled so that row 25 is at the top of the visible data.

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

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

Table with ten rows and three columns of numerical data.

테이블 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];

Table with three rows and three columns. The first column contains text, the second column contains numerical data, and the third column contains check boxes. The check boxes in the first and second rows are selected.

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

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

Table with three rows and three columns. Each column has a column name above the data.

입력 인수

모두 축소

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

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

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

이름-값 인수

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

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

예: uitable(fig,'Data',[1 2 3; 4 5 6])

참고

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

테이블 데이터로, 다음 배열 유형 중 하나로 지정됩니다.

  • table형 배열(uifigure 기반 앱만 해당) — datetime형, duration형 및 categorical형과 같이 table형 배열이 지원하는 모든 데이터형 조합을 표시합니다.

  • 숫자형 배열 — double형 또는 single형과 같은 숫자형 값을 표시합니다.

  • 논리형 배열 — 체크박스를 표시합니다. true 값은 선택된 체크박스에 해당하고 false 값은 선택 취소된 체크박스를 표시합니다.

  • 셀형 배열 — 숫자형, 논리형 또는 문자형 배열 값의 조합을 표시합니다.

  • string형 배열 — 문자 및 텍스트를 표시합니다.

  • 문자형 벡터로 구성된 셀형 배열 — 문자 및 텍스트를 표시합니다.

사용자가 편집 가능한 셀에 유효하지 않은 데이터를 입력할 때 경고 또는 NaN 값이 발생하는 것을 방지하려면 CellEditCallback 함수를 작성하여 데이터를 적절한 유형으로 변환하십시오. 사용자가 셀을 편집하면 Data 속성이 업데이트됩니다.

table형 배열 지정하기

앱 디자이너 및 uifigure 함수를 사용하여 만든 앱에서는 Data 속성을 table형 배열로 지정할 수 있습니다. table형 배열은 테이블 형식 데이터를 MATLAB 변수로 저장하는 편리한 방법을 제공합니다. table, readtable 및 array2table 함수는 table형 배열을 만듭니다. 반대로 uitable 함수는 Table UI 구성요소(앱의 사용자 인터페이스 구성요소)를 만듭니다.

Table UI 구성요소의 Data 속성을 table형 배열로 지정한 경우 MATLAB은 table형 배열의 값을 기반으로 Table UI 구성요소의 형식을 자동으로 설정합니다.

  • 기본적으로 앱에 표시되는 열 이름은 table형 배열의 VariableNames 속성과 일치합니다. Table UI 구성요소의 ColumnName 속성을 변경하면 UI가 업데이트되지만 table형 배열의 변수 이름은 업데이트되지 않습니다.

  • 기본적으로 앱에 표시되는 행 이름은 table형 배열의 RowName 속성과 일치합니다. Table UI 구성요소의 RowName 속성을 변경하면 UI가 업데이트되지만 table형 배열의 행 이름은 업데이트되지 않습니다.

  • table형 배열의 각 변수의 데이터형은 앱에서 해당 열의 형식을 제어합니다. ColumnFormat 속성을 설정하려고 하면 MATLAB이 경고를 반환합니다.

table형 배열 데이터 표시에 대한 자세한 내용은 앱 디자이너로 만든 앱의 table형 배열 데이터 유형 항목을 참조하십시오.

숫자형, 논리형, 셀형, string형 배열 또는 문자형 벡터로 구성된 셀형 배열 지정하기

ColumnFormat 속성을 사용하여 숫자형, 논리형, 셀형, string형 배열, 또는 문자형 벡터로 구성된 셀형 배열로 데이터 형식을 지정합니다. 데이터가 편집되어 데이터의 데이터형과 ColumnFormat 속성이 일치하지 않으면 MATLAB이 데이터를 변환하거나 경고를 표시합니다. 자세한 내용은 ColumnFormat 속성 설명에서 편집 가능한 열의 데이터 표시 항목을 참조하십시오.

테이블 열의 너비로, 'auto'로 지정되거나 문자형 벡터, string형 및 숫자형 값으로 구성된 1×n 셀형 배열로 지정됩니다. uifigure 기반 앱에서는 추가적으로 열 너비를 '1x' 또는 'fit'으로 지정할 수 있습니다.

  • 자동 너비 — MATLAB에서 ColumnName 속성값 등의 여러 인수를 사용하여 열 너비를 자동으로 계산하도록 하려면 'auto'를 지정합니다.

  • 콘텐츠에 너비 맞추기(uifigure 기반 앱만 해당) — 열 이름과 데이터에 꼭 맞게 열 너비를 구성하려면 값을 'fit'으로 지정합니다. 이 설정을 사용하면 'auto'보다 좁은 열 너비가 지원됩니다.

  • 균일 너비(uifigure 기반 앱만 해당) — 사용 가능한 공간을 균일하게 나누어 열 너비를 모두 같게 만들려면 값을 '1x'로 지정합니다.

  • 고정 너비 — 열 너비를 픽셀 단위로 정의하는 숫자형 값으로 구성된 셀형 배열을 지정합니다.

  • 조합 — 셀형 배열에 고정 열 너비와 가변 열 너비를 조합할 수 있습니다. 셀형 배열의 각 요소는 테이블의 열에 해당합니다. 지정한 셀형 배열에 열 개수보다 적은 값이 있는 경우 지정한 값이 없는 열은 디폴트 값인 'auto'로 유지됩니다. 배열에 열 개수보다 많은 값이 있는 경우 MATLAB은 여분의 값을 무시합니다.

  • 가중 가변 너비(uifigure 기반 앱만 해당) — 숫자에 'x'가 결합된 문자형 벡터 또는 string형으로 구성된 셀형 배열을 지정합니다(예: '2x', '3x' 등). 각 열의 x 인자는 UI 테이블의 나머지 공간을 고려하여 다른 열에 상대적으로 해당 열의 너비를 비례적으로 설정합니다.

실행 중인 앱에서 사용자가 대화형 방식으로 테이블 열의 크기를 조정하면 나중에 ColumnWidth 속성을 업데이트하더라도 크기 조정된 열 너비는 그대로 유지됩니다.

예: uit = uitable(uifigure,'ColumnWidth','auto','Data',[1 2 3;4 5 6])

예: uit = uitable(uifigure,'ColumnWidth','fit','Data',[1 2 3;4 5 6])

예: uit = uitable(uifigure,'ColumnWidth',{64,60,40},'Data',[1 2 3;4 5 6])

예: uit = uitable(uifigure,'ColumnWidth',{'2x','1x','1x'},'Data',[1 2 3;4 5 6])

예: uit = uitable(uifigure,'ColumnWidth',{64,"auto",40},'Data',[1 2 3;4 5 6])

예: uit = uitable(uifigure,'ColumnWidth',{'fit','1x','3x'},'Data',[1 2 3;4 5 6])

열 셀 편집 기능으로, 다음과 같이 지정됩니다.

  • 빈 논리형 배열([]) — 편집 가능한 열이 없습니다.

  • 논리형 1×n 배열 — 이 배열은 편집 가능한 열을 지정합니다. n 값은 테이블의 열 개수와 같습니다. 배열의 각 값은 테이블 열에 해당합니다. 배열에서 true 값은 해당 열의 셀을 편집 가능하게 만듭니다. 값이 false이면 해당 열의 셀을 편집할 수 없습니다. 배열에 열 개수보다 많은 값이 있는 경우 MATLAB은 초과된 값을 무시합니다. 배열에 열 개수보다 적은 값이 있는 경우 지정된 값이 없는 열은 편집할 수 없습니다.

  • 논리형 스칼라 — 전체 테이블이 편집 가능하거나 편집 불가능합니다.

사용자가 셀을 편집하면 Data 속성이 업데이트됩니다.

예: uit = uitable(uifigure,'Data',rand(10,3),'ColumnEditable',[false true true])

예: uit = uitable(uifigure,'Data',rand(10,3),'ColumnEditable',false)

사용자가 체크박스 또는 팝업 메뉴가 포함된 테이블 열의 컨트롤과 상호 작용할 수 있게 하려면 ColumnEditable 속성을 true로 설정하십시오.

Data 속성이 table형 배열인 경우, ColumnEditable 속성이 true인 경우에도 여러 열로 구성되거나 duration과 같이 편집할 수 없는 데이터형을 포함하는 변수는 실행 중인 앱에서 편집할 수 없습니다. 셀형 배열에 혼합된 데이터형을 포함하는 table형 배열 변수는 데이터형을 편집할 수 있는 한 실행 중인 앱에서 편집이 가능합니다.

셀 편집 콜백 함수로, 다음 값 중 하나로 지정됩니다.

  • 함수 핸들.

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

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

앱 사용자가 테이블 셀의 내용을 변경할 때 계산하거나 입력값을 검사하도록 하려면 이 콜백 함수를 사용하십시오.

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

다음 표에서는 CellEditData 객체의 속성에 대해 설명합니다.

속성

설명

Indices

사용자가 실행 중인 앱에서 편집한 셀의 행 및 열 인덱스를 포함하는 1×2 배열입니다. 열이 정렬되면 Indices는 정렬되기 전 셀로 구성된 원래 1×2 배열을 반환합니다. DisplayIndices는 정렬된 테이블에 시각적으로 표시되는 편집된 셀의 새 위치를 반환합니다.

DisplayIndices

정렬된 테이블의 표시화면에서 편집된 셀의 위치에 해당하는 행 및 열 인덱스를 포함하는 1×2 배열입니다. 사용자가 열을 정렬하지 않은 경우 DisplayIndices의 내용은 Indices 속성의 내용과 동일합니다.

PreviousData

이전 셀 데이터입니다. 디폴트 값은 빈 행렬 []입니다.

EditData

사용자가 입력한 값입니다.

NewData

MATLAB에서 Data 속성 배열에 쓴 값입니다.

MATLAB이 사용자가 입력한 데이터에서 오류를 감지하면 NewData 속성이 비어 있습니다.

Error

MATLAB이 사용자가 입력한 데이터에서 오류를 감지한 경우 반환되는 오류 메시지입니다.

MATLAB이 값을 Data 속성에 성공적으로 쓰면 Error 속성이 비어 있습니다.

Error 속성이 비어 있지 않으면 CellEditCallback에 메시지가 표시되거나 문제 해결을 시도할 수 있습니다.

Source

콜백을 실행하는 구성요소입니다.

EventName

'CellEdit'.

사용자가 테이블 셀을 편집하면 MATLAB이 다음 단계를 수행합니다.

  1. 테이블의 Data 속성에 새 값을 저장합니다.

  2. CellEditCallback 함수를 호출합니다(있는 경우).

값에 오류가 있는데 CellEditCallback 함수가 없는 경우 셀 데이터가 이전 값으로 되돌아가고 오류가 표시되지 않습니다.

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

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

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

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

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

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

단위 값설명
'pixels'(디폴트 값)

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

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

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

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

'normalized'

이 단위는 부모 컨테이너에 대해 정규화됩니다. 컨테이너의 왼쪽 아래 코너는 (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 항목을 참조하십시오.

버전 내역

R2008a에 개발됨

모두 확장

참고 항목

함수

속성

도움말 항목