TiledChartLayout 속성

타일 형식 차트 레이아웃의 모양과 동작

R2019b 이후

타일 형식 차트 레이아웃은 그림에 플롯을 타일 형식으로 표시하기 위한 컨테이너입니다. 각 타일은 플롯을 표시할 axes 객체를 포함할 수 있습니다. 속성값을 변경하여 레이아웃의 특성을 수정할 수 있습니다.

t = tiledlayout(2,2);
t.TileSpacing = 'compact';

레이아웃

GridSize — 그리드 크기

[m n] 형식의 벡터

그리드 크기로, [m n] 형식의 벡터로 지정됩니다. 여기서 m은 행 개수이며 n은 열 개수입니다. 레이아웃에 있는 모든 타일이 비어 있는 경우에만 이 속성을 설정할 수 있습니다. 이 속성을 설정하면 MATLAB^®은 TileArrangement 속성을 'fixed'로 설정합니다.

TileArrangement 속성이 'flow'로 설정된 레이아웃의 경우 이 속성의 값이 자동으로 변경될 수 있습니다. 예를 들어 부모 컨테이너의 크기가 조정되거나 레이아웃에 있는 좌표축 개수가 변하면 그리드 크기가 이러한 변경 사항을 수용하도록 업데이트됩니다.

TileArrangement — 타일 배열

"fixed" | "flow" | "vertical" | "horizontal"

읽기 전용 속성입니다.

타일 배열로, 다음 값 중 하나로 반환됩니다.

• "fixed" — 레이아웃은 GridSize 속성에 의해 결정되는 고정된 행 및 열 개수를 가진 그리드입니다. 이 타일 배열을 갖는 m×n 레이아웃은 최대 m*n개의 플롯을 표시할 수 있습니다.

• "flow" — 레이아웃은 가변적인 개수의 행과 열을 가진 그리드입니다. nexttile을 호출할 때마다 모든 타일에 대해 가로 세로 비율을 약 4:3으로 유지하면서 새 좌표축을 수용하는 데 필요한 만큼 레이아웃이 재배치됩니다.

• "vertical" — 레이아웃에 좌표축이 세로로 누적됩니다. nexttile을 호출할 때마다 새로운 axes 객체가 쌓임 순서의 맨 아래에 추가됩니다. (R2023a 이후)

• "horizontal" — 레이아웃에 좌표축이 가로로 누적됩니다. nexttile을 호출할 때마다 새로운 axes 객체가 쌓임 순서의 오른쪽에 추가됩니다. (R2023a 이후)

GridSize 속성을 수동으로 설정하면 MATLAB은 이 속성의 값을 "fixed"로 설정합니다.

타일 배열을 설정하려면 tiledlayout 함수를 호출할 때 arrangement 인수를 지정하십시오.

TileSpacing — 타일 간격

"loose" (디폴트 값) | "compact" | "tight" | "none"

타일 간격으로, "loose", "compact", "tight" 또는 "none"으로 지정됩니다. 이 속성을 사용하여 타일 사이의 간격을 제어합니다.

다음 표에서는 각 값이 2×2 레이아웃 모양에 어떤 영향을 미치는지 보여줍니다.

값	모양
"loose"
"compact"
"tight"
"none"

Padding — 레이아웃 주변 채우기

"loose" (디폴트 값) | "compact" | "tight"

레이아웃 주변 채우기로, "loose", "compact" 또는 "tight"로 지정됩니다. 레이아웃은 이 속성의 값에 관계없이 축 레이블과 같은 모든 장식을 위한 공간을 제공합니다.

다음 표에서는 각 값이 2×2 레이아웃 모양에 어떤 영향을 미치는지 보여줍니다.

값	모양
"loose"
"compact"
"tight"

TileIndexing — 타일 인덱싱 방식

'rowmajor' (디폴트 값) | 'columnmajor'

타일 인덱싱 방식으로, 다음 표의 값으로 지정됩니다. nexttile 함수는 이 인덱싱 방식에 따라 타일을 채웁니다. 채워진 레이아웃의 타일 인덱싱 방식으로 변경하면 타일 위치가 새 방식에 맞게 변경됩니다. nexttile을 호출하여 지정된 타일의 axes 객체를 가져오면 인덱싱 방식은 MATLAB이 반환하는 axes 객체에도 영향을 줍니다.

값	설명
'rowmajor'	타일 번호가 행에 대해 왼쪽에서 오른쪽으로 증가합니다. 예를 들어 이 그림은 2×2 레이아웃의 행 우선 타일 인덱스를 보여줍니다.
'columnmajor'	타일 번호가 열에 대해 아래쪽으로 증가합니다. 예를 들어 이 그림은 2×2 레이아웃의 열 우선 타일 인덱스를 보여줍니다.

레이블

Title — 공유 제목의 Text 객체

Text 객체

공유 제목의 Text 객체입니다. 공유 제목을 추가하려면 Text 객체의 String 속성을 설정하십시오. 기타 속성을 설정하여 글꼴 스타일 또는 색과 같은 제목 모양을 변경할 수 있습니다. 예를 들어, 굵은 글꼴 두께를 가진 2×2 레이아웃의 공유 제목을 만듭니다.

t = tiledlayout(2,2);
t.Title.String = 'My Title';
t.Title.FontWeight = 'bold';

또는 title 함수에 TiledChartLayout 객체를 전달합니다.

title(t,'My Title','FontWeight','normal')

지정할 수 있는 전체 속성 목록은 Text 속성 항목을 참조하십시오.

참고

Text 객체는 레이아웃의 Children 속성에 포함되어 있지 않으므로 findobj 함수에 의해 반환될 수 없습니다.

Subtitle — 공유 부제목의 Text 객체

text 객체

공유 부제목의 Text 객체입니다. 부제목을 추가하려면 text 객체의 String 속성을 설정하십시오. 글꼴 각도 등의 모양을 변경하려면 기타 속성을 설정하십시오. 전체 목록을 보려면 Text 속성를 참조하십시오.

t = tiledlayout(2,2);
t.Subtitle.String = 'An Insightful Subtitle';
t.Subtitle.FontAngle = 'italic';

또는 subtitle 함수를 사용하면 부제목을 추가하고 모양을 제어할 수 있습니다.

subtitle('An Insightful Subtitle','FontAngle','italic')

아니면 title 함수를 사용하고 두 개의 문자형 벡터 입력 인수와 두 개의 출력 인수를 지정하십시오. 그런 다음 함수가 반환하는 두 번째 text 객체에서 속성을 설정하십시오.

[tt,s] = title(t,'Clever Title','An Insightful Subtitle');
s.FontAngle = 'italic';

참고

이 text 객체는 좌표축의 Children 속성에 포함되어 있지 않으며, findobj에서 반환할 수 없고, text 객체에 대해 정의된 디폴트 값을 사용하지 않습니다.

XLabel — 공유 x축 레이블의 Text 객체

Text 객체

공유 x축 레이블의 Text 객체입니다. 공유 x축 레이블을 추가하려면 text 객체의 String 속성을 설정하십시오. 기타 속성을 설정하여 글꼴 크기 등의 레이블 모양을 변경할 수 있습니다. 예를 들어, 2×2 레이아웃의 14포인트 글꼴이 지정된 공유 x축 레이블을 만듭니다.

t = tiledlayout(2,2);
t.XLabel.String = 'My x-Axis Label';
t.XLabel.FontSize = 14;

또는 xlabel 함수에 TiledChartLayout 객체를 전달합니다.

xlabel(t,'My x-Axis Label','FontSize',14)

지정할 수 있는 전체 속성 목록은 Text 속성 항목을 참조하십시오.

참고

Text 객체는 좌표축의 Children 속성에 포함되어 있지 않으므로 findobj 함수에서 반환할 수 없습니다.

YLabel — 공유 y축 레이블의 Text 객체

Text 객체

공유 y축 레이블의 Text 객체입니다. 공유 y축 레이블을 추가하려면 text 객체의 String 속성을 설정하십시오. 기타 속성을 설정하여 글꼴 크기 등의 레이블 모양을 변경할 수 있습니다. 예를 들어, 2×2 레이아웃의 14포인트 글꼴이 지정된 공유 y축 레이블을 만듭니다.

t = tiledlayout(2,2);
t.YLabel.String = 'My y-Axis Label';
t.YLabel.FontSize = 14;

또는 ylabel 함수에 TiledChartLayout 객체를 전달합니다.

ylabel(t,'My y-Axis Label','FontSize',14)

지정할 수 있는 전체 속성 목록은 Text 속성 항목을 참조하십시오.

참고

Text 객체는 좌표축의 Children 속성에 포함되어 있지 않으므로 findobj 함수에서 반환할 수 없습니다.

위치

OuterPosition — 외부 크기와 위치

[0 0 1 1] (디폴트 값) | 요소를 4개 가진 벡터

제목과 축 레이블 같은 장식용 여백을 포함한 외부 크기와 위치로, [left bottom width height] 형식의 4개 요소를 가진 벡터로 지정됩니다. 벡터의 값은 Units 속성으로 지정된 단위로 표시됩니다. 디폴트 값 [0 0 1 1]은 컨테이너의 전체 내부를 포함합니다.

• left 요소와 bottom 요소는 컨테이너(주로 figure, panel 또는 tab)의 왼쪽 아래 코너에서 외부 위치 경계의 왼쪽 아래 코너까지 거리를 정의합니다.

• width 요소와 height 요소는 외부 위치 경계의 크기입니다.

다음 레이아웃에서 파란색 사각형은 OuterPosition 속성을 나타내며 빨간색 사각형은 (같은 값을 가진) InnerPosition 및 Position 속성을 나타냅니다.

참고

부모 컨테이너가 TiledChartLayout 객체일 때는 이 속성을 설정해도 아무 효과가 없습니다.

InnerPosition — 내부 크기와 위치

[0.1300 0.1100 0.7750 0.8150] (디폴트 값) | 요소를 4개 가진 벡터

제목과 축 레이블 같은 장식용 여백을 제외한 내부 크기와 위치로, [left bottom width height] 형식의 4개 요소를 가진 벡터로 지정됩니다. 이 속성은 Position 속성과 동일합니다.

참고

부모 컨테이너가 TiledChartLayout 객체일 때는 이 속성을 설정해도 아무 효과가 없습니다.

Position — 내부 크기와 위치

[0.1300 0.1100 0.7750 0.8150] (디폴트 값) | 요소를 4개 가진 벡터

제목과 축 레이블 같은 장식용 여백을 제외한 내부 크기와 위치로, [left bottom width height] 형식의 4개 요소를 가진 벡터로 지정됩니다. 벡터의 값은 Units 속성으로 지정된 단위로 표시됩니다.

• left 요소와 bottom 요소는 컨테이너(주로 figure, panel 또는 tab)의 왼쪽 아래 코너에서 위치 경계의 왼쪽 아래 코너까지 거리를 정의합니다.

• width 요소와 height 요소는 위치 경계의 크기입니다. 3차원 보기에 있는 좌표축의 경우 Position 속성은 좌표축을 둘러싸는 가장 작은 사각형입니다.

다음 레이아웃에서 파란색 사각형은 OuterPosition 속성을 나타내며 빨간색 사각형은 (같은 값을 가진) InnerPosition 및 Position 속성을 나타냅니다.

참고

부모 컨테이너가 TiledChartLayout 객체일 때는 이 속성을 설정해도 아무 효과가 없습니다.

PositionConstraint — 일정하게 유지할 위치

"outerposition" | "innerposition"

장식을 추가하거나, 제거하거나, 변경할 때 위치를 일정하게 유지하는 속성으로, 다음 값 중 하나로 지정됩니다.

• "outerposition" — 제목이나 축 레이블 같은 장식을 추가하거나, 제거하거나, 변경할 때 OuterPosition 속성이 일정하게 유지됩니다. 위치 조정이 필요할 경우에는 MATLAB이 InnerPosition 속성을 조정합니다.

• "innerposition" — 제목이나 축 레이블 같은 장식을 추가하거나, 제거하거나, 변경할 때 InnerPosition 속성이 일정하게 유지됩니다. 위치 조정이 필요할 경우에는 MATLAB이 OuterPosition 속성을 조정합니다.

참고

부모 컨테이너가 TiledChartLayout 객체일 때는 이 속성을 설정해도 아무 효과가 없습니다.

Units — 위치 단위

'normalized' (디폴트 값) | 'inches' | 'centimeters' | 'characters' | 'points' | 'pixels'

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

Units	설명
'normalized'(디폴트 값)	부모 컨테이너에 대해 정규화됩니다. 부모 컨테이너는 일반적으로 Figure입니다. Figure의 왼쪽 아래 코너는 (0,0)에 매핑되고 오른쪽 위 코너는 (1,1)에 매핑됩니다.
'inches'	인치.
'centimeters'	센티미터.
'characters'	디폴트 시스템 글꼴의 문자 크기를 기반으로 합니다. 문자 너비 = 문자 x의 너비. 문자 높이 = 텍스트의 두 줄의 기준선 간 거리.
'points'	포인트. 1포인트는 1/72인치와 같습니다.
'pixels'	픽셀. Windows® 시스템에서 1픽셀은 1/96인치입니다. Macintosh 시스템에서 1픽셀은 1/72인치입니다. Linux® 시스템에서 픽셀 크기는 시스템 해상도에 의해 결정됩니다.

모든 단위는 부모 컨테이너의 왼쪽 아래 코너를 기준으로 측정됩니다.

이 속성은 Position 속성과 같은 다른 속성에 영향을 미칩니다. 단위를 변경한 경우, 계산을 완료한 후에 디폴트 값이 설정된 것으로 간주하는 다른 함수에 영향을 미치지 않도록 단위를 디폴트 값으로 복원하십시오.

객체를 만들 때 Position 속성과 Units 속성을 Name,Value 쌍으로 지정하는 경우, 지정 순서가 중요합니다. 예를 들어, 특정 단위에 위치를 설정하려면 Position 속성 전에 먼저 Units 속성을 설정해야 합니다.

Layout — 레이아웃 옵션

빈 LayoutOptions 배열 (디폴트 값) | TiledChartLayoutOptions 객체

레이아웃 옵션으로, TiledChartLayoutOptions 객체로 지정됩니다. 이 속성을 사용하여 중첩된 레이아웃을 해당 부모 레이아웃 내에 배치합니다. 예를 들어 레이아웃을 또 다른 타일 형식 차트 레이아웃 내에 배치하려면 TiledChartLayoutOptions 객체에서 Tile 속성과 TileSpan 속성을 설정하십시오.

예를 들어 다음 코드는 layout2를 layout1의 세 번째 타일에 배치합니다.

layout1 = tiledlayout(2,2);
layout2 = tiledlayout(layout1,1,3);
layout2.Layout.Tile = 3;

중첩된 레이아웃을 여러 타일에 걸쳐 배치하려면 TileSpan 속성을 요소를 2개 가진 벡터로 지정하십시오. 예를 들어, 다음 코드는 타일 layout2의 1개 행과 2개 열에 걸쳐 배치됩니다.

layout2.Layout.TileSpan = [1 2];

두 레이아웃의 모든 타일을 채우면 복합 레이아웃은 다음과 같이 보입니다.

레이아웃이 또 다른 레이아웃의 자식이 아닌 경우, 예를 들어 Figure 또는 패널의 자식인 경우, 이 속성은 비어 있고 영향을 미치지 않습니다.

상호 작용

Toolbar — 공유 데이터 탐색 도구 모음

빈 GraphicPlaceholder 배열 (디폴트 값) | AxesToolbar 객체

공유 데이터 탐색 도구 모음으로, axtoolbar 함수에 의해 반환된 AxesToolbar 객체로 지정됩니다. 레이아웃 위에 커서를 올려놓으면 레이아웃의 우측 상단 코너에 도구 모음이 표시됩니다.

기본적으로, 공유 도구 모음이 없으며 각 개별 axes 객체는 자체 도구 모음을 갖습니다. 공유 도구 모음을 만들면 개별 axes 객체의 도구 모음은 숨겨집니다. 레이아웃에 도구 모음을 두고 싶지 않은 경우, 이 속성을 비워 두고 각 좌표축에 대해 AxesToolbar 객체의 Visible 속성을 'off'로 설정하십시오.

t = tiledlayout(2,1);
ax = nexttile;
ax.Toolbar.Visible = 'off';

Visible — 가시성 상태

"on" (디폴트 값) | on/off 논리값

가시성 상태로, "on" 또는 "off"나 숫자형 값 또는 논리값 1(true) 또는 0(false)으로 지정됩니다. 값 "on"은 true와 동일하고 값 "off"는 false와 동일합니다. 따라서 이 속성의 값을 논리값으로 사용할 수 있습니다. 값은 matlab.lang.OnOffSwitchState 유형의 on/off 논리값으로 저장됩니다.

• "on" — 객체를 표시합니다.

• "off" — 객체를 삭제하지 않고 숨깁니다. 보이지 않는 객체의 속성에 계속 액세스할 수 있습니다.

콜백

GridSizeChangedFcn — 그리드 크기 변경 콜백

"" (디폴트 값) | 함수 핸들 | 셀형 배열 | string형 스칼라 | 문자형 벡터

R2022b 이상

그리드 크기 변경 콜백으로, 다음 값 중 하나로 지정됩니다.

• 함수 핸들.

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

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

TileArrangement 속성을 "fixed"로 설정한 레이아웃은 레이아웃이 비어 있어야만 그리드 크기를 바꿀 수 있습니다. 이 콜백은 GridSize 속성이 변경된 후에 실행합니다. 그리드 크기는 대개 TileArrangement 속성이 "flow"로 설정되어 있을 때 사용자가 타일을 추가 또는 제거하거나 Figure의 크기를 조정하는 경우 변경됩니다.

GridSizeChangedFcn 콜백 함수는 그리드 크기에 대한 특정 정보에 액세스할 수 있습니다. MATLAB은 이 정보를 콜백 함수에 대한 두 번째 인수로서 GridSizeChanged 객체에 전달합니다. 앱 디자이너에서 앱을 개발할 때는 이 인수를 event라고 부릅니다. 점 표기법을 사용하여 객체 속성을 쿼리할 수 있습니다. 예를 들어, event.NewGridSize는 새 그리드 크기를 반환합니다. GridSizeChanged 객체는 string형 또는 문자형 벡터로 지정된 콜백 함수에 사용할 수 없습니다.

다음 표에는 GridSizeChanged 객체 속성이 나열되어 있습니다.

속성	설명
NewGridSize	새 그리드 크기를 포함하는, 요소를 2개 가진 벡터
OldGridSize	이전 그리드 크기를 포함하는, 요소를 2개 가진 벡터
Source	콜백을 실행하는 TiledChartLayout 객체
EventName	'GridSizeChanged'

GridSizeChangedFcn 콜백에 대한 예는 타일이 재배치되면 조정되는 컬러바 항목을 참조하십시오. 앱에서 콜백을 작성하는 방법에 대한 자세한 내용은 앱 디자이너에서 콜백 사용하기 항목을 참조하십시오.

CreateFcn — 생성 함수

'' (디폴트 값) | 함수 핸들 | 셀형 배열 | 문자형 벡터

객체 생성 함수로, 다음 값 중 하나로 지정됩니다.

• 함수 핸들.

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

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

콜백을 함수 핸들, 셀형 배열 또는 문자형 벡터로 지정하는 방법에 대한 자세한 내용은 그래픽스 객체에 대한 콜백 만들기 항목을 참조하십시오.

이 속성은 MATLAB이 객체를 생성할 때 실행할 콜백 함수를 지정합니다. MATLAB은 CreateFcn 콜백을 실행하기 전에 모든 속성값을 초기화합니다. CreateFcn 속성을 지정하지 않으면 MATLAB은 디폴트 생성 함수를 실행합니다.

기존 컴포넌트에 대해서는 CreateFcn 속성을 설정해도 아무 효과가 없습니다.

이 속성을 함수 핸들 또는 셀형 배열로 지정하면 생성 중인 객체에 콜백 함수의 첫 번째 인수를 사용하여 액세스할 수 있습니다. 이 속성을 함수 핸들 또는 셀형 배열로 지정하지 않은 경우에는 gcbo 함수를 사용하여 객체에 액세스하십시오.

DeleteFcn — 삭제 함수

'' (디폴트 값) | 함수 핸들 | 셀형 배열 | 문자형 벡터

객체 삭제 함수로, 다음 값 중 하나로 지정됩니다.

• 함수 핸들.

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

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

콜백을 함수 핸들, 셀형 배열 또는 문자형 벡터로 지정하는 방법에 대한 자세한 내용은 그래픽스 객체에 대한 콜백 만들기 항목을 참조하십시오.

이 속성은 MATLAB에서 객체를 삭제할 때 실행할 콜백 함수를 지정합니다. MATLAB은 객체의 속성을 파괴하기 전에 DeleteFcn 콜백을 실행합니다. DeleteFcn 속성을 지정하지 않으면 MATLAB은 디폴트 삭제 함수를 실행합니다.

이 속성을 함수 핸들 또는 셀형 배열로 지정하면 삭제 중인 객체에 콜백 함수의 첫 번째 인수를 사용하여 액세스할 수 있습니다. 이 속성을 함수 핸들 또는 셀형 배열로 지정하지 않은 경우에는 gcbo 함수를 사용하여 객체에 액세스하십시오.

콜백 실행 컨트롤

Interruptible — 콜백 중단

'on' (디폴트 값) | on/off 논리값

콜백 중단으로, 'on' 또는 'off'나 숫자형 값 또는 논리값 1(true) 또는 0(false)으로 지정됩니다. 값 'on'은 true와 동일하고 값 'off'는 false와 동일합니다. 따라서 이 속성의 값을 논리값으로 사용할 수 있습니다. 값은 matlab.lang.OnOffSwitchState 유형의 on/off 논리값으로 저장됩니다.

이 속성은 실행중 콜백을 중단할 수 있는지 여부를 지정합니다. 고려할 콜백 상태에는 다음 두 가지가 있습니다.

• 실행중 콜백은 현재 실행되고 있는 콜백입니다.

• 인터럽트 콜백은 실행중 콜백을 중단하고 자신이 실행되려는 콜백입니다.

MATLAB은 콜백 대기열을 처리하는 명령을 실행할 때마다 콜백 중단 동작을 결정합니다. 이러한 명령에는 drawnow, figure, uifigure, getframe, waitfor, pause가 포함됩니다.

실행중 콜백에 이러한 명령이 포함되어 있지 않으면 중단이 발생하지 않습니다. MATLAB은 먼저 실행중 콜백의 실행을 완료한 다음 인터럽트 콜백을 실행합니다.

실행중 콜백에 이러한 명령이 포함되어 있으면 실행중 콜백을 소유한 객체의 Interruptible 속성에서 중단을 발생시킬지 여부를 결정합니다.

• Interruptible 값이 'off'이면 중단이 발생하지 않습니다. 대신 인터럽트 콜백을 소유한 객체의 BusyAction 속성이 인터럽트 콜백을 삭제할지 아니면 콜백 대기열에 추가할지 결정합니다.

• Interruptible 값이 'on'이면 중단이 발생합니다. MATLAB이 다음번 콜백 대기열을 처리할 때 실행중 콜백의 실행을 중지하고 인터럽트 콜백을 실행합니다. 인터럽트 콜백이 완료된 후에는 MATLAB이 실행 중인 콜백의 실행을 재개합니다.

참고

콜백 중단과 실행은 다음 상황에서 다르게 동작합니다.

• 인터럽트 콜백이 DeleteFcn, CloseRequestFcn, SizeChangedFcn 콜백 중 하나이면 Interruptible 속성값에 관계없이 중단이 발생합니다.

• 실행중 콜백이 현재 waitfor 함수를 실행 중이면 Interruptible 속성값에 관계없이 중단이 발생합니다.

• 인터럽트 콜백을 Timer 객체가 소유한 경우 콜백은 Interruptible 속성값에 관계없이 예약된 대로 실행됩니다.

참고

중단이 발생하면 MATLAB은 디스플레이 또는 속성의 상태를 저장하지 않습니다. 예를 들어, 다른 콜백이 실행될 때 gca 또는 gcf 명령이 반환하는 객체가 변경될 수도 있습니다.

BusyAction — 콜백 대기

'queue' (디폴트 값) | 'cancel'

콜백 대기로, 'queue'나 'cancel'로 지정됩니다. BusyAction 속성은 MATLAB이 인터럽트 콜백의 실행을 처리하는 방법을 지정합니다. 고려할 콜백 상태에는 다음 두 가지가 있습니다.

• 실행중 콜백은 현재 실행되고 있는 콜백입니다.

• 인터럽트 콜백은 실행중 콜백을 중단하고 자신이 실행되려는 콜백입니다.

BusyAction 속성은 다음 조건이 모두 충족될 때만 콜백 대기 동작을 결정합니다.

• 실행중 콜백에 콜백 대기열을 처리하는 drawnow, figure, uifigure, getframe, waitfor 또는 pause 같은 명령이 포함되어 있습니다.

• 실행중 콜백을 소유하는 객체의 Interruptible 속성값이 'off'입니다.

이러한 조건에서는 인터럽트 콜백을 소유하는 객체의 BusyAction 속성값이 MATLAB에서 인터럽트 콜백을 처리하는 방식을 결정합니다. BusyAction 속성의 가능한 값은 다음과 같습니다.

• 'queue' — 실행중 콜백이 실행을 마치고 나면 인터럽트 콜백이 처리되도록 대기열에 넣습니다.

• 'cancel' — 인터럽트 콜백을 실행하지 않습니다.

BeingDeleted — 삭제 상태

on/off 논리값

읽기 전용 속성입니다.

삭제 상태로, matlab.lang.OnOffSwitchState 유형의 on/off 논리값으로 반환됩니다.

MATLAB은 DeleteFcn 콜백이 실행을 시작할 때 BeingDeleted 속성을 'on'으로 설정합니다. BeingDeleted 속성은 컴포넌트 객체가 더 이상 존재하지 않을 때까지 'on'으로 설정되어 유지됩니다.

객체를 쿼리하거나 수정하기 전에 BeingDeleted 속성의 값을 확인하여 이 객체가 곧 삭제될 것이 아님을 확인합니다.

부모/자식

Parent — 부모 컨테이너

Figure 객체 | Panel 객체 | Tab 객체 | TiledChartLayout 객체

부모 컨테이너로, Figure, Panel, Tab 또는 TiledChartLayout 객체로 지정됩니다.

Children — 자식

빈 GraphicsPlaceholder 배열 | 그래픽스 객체로 구성된 배열

자식으로, 그래픽스 객체로 구성된 배열로 반환됩니다. 이 속성을 사용하여 자식 목록을 표시하거나, 속성을 자기 자신의 치환으로 설정하여 자식을 재정렬할 수 있습니다.

Children 속성을 사용해서는 자식을 추가하거나 제거할 수 없습니다. 이 목록에 자식을 추가하려면 자식 그래픽스 객체의 Parent 속성을 TiledChartLayout 객체로 설정하십시오.

HandleVisibility — 객체 핸들의 가시성

"on" (디폴트 값) | "off" | "callback"

부모의 Children 속성에 있는 객체 핸들의 가시성으로, 다음 값 중 하나로 지정됩니다.

• "on" — 객체 핸들이 항상 표시됩니다.

• "off" — 객체 핸들이 항상 표시되지 않습니다. 이 옵션은 다른 함수에 의해 의도치 않게 변경되는 것을 방지하는 데 유용합니다. HandleVisibility를 "off"로 설정하여 해당 함수를 실행하는 동안 핸들을 일시적으로 숨길 수 있습니다.

• "callback" — 명령줄에서 호출한 함수 내에서가 아니라, 콜백 내에서나 콜백이 호출한 함수 내에서 객체 핸들이 표시됩니다. 이 옵션은 명령줄에서 객체에 액세스하는 것은 차단하지만, 콜백 함수가 이 객체에 액세스하는 것은 허용합니다.

객체가 부모의 Children 속성에 나열되지 않는 경우, 객체 계층 구조를 검색하거나 핸들 속성을 쿼리하여 객체 핸들을 가져오는 함수가 이 객체를 반환할 수 없습니다. 이러한 함수의 예로는 get, findobj, gca, gcf, gco, newplot, cla, clf 및 close 함수가 있습니다.

숨겨진 객체 핸들은 여전히 유효합니다. 루트 ShowHiddenHandles 속성을 "on"으로 설정하면 객체 핸들의 HandleVisibility 속성 설정에 관계없이 모든 객체 핸들을 나열할 수 있습니다.

식별자

Type — 그래픽스 객체의 유형

'tiledlayout'

읽기 전용 속성입니다.

그래픽스 객체의 유형으로, 'tiledlayout'으로 반환됩니다.

Tag — 객체 식별자

'' (디폴트 값) | 문자형 벡터 | string형 스칼라

객체 식별자로, 문자형 벡터 또는 string형 스칼라로 지정됩니다. 객체의 식별자로 사용할 고유 Tag 값을 지정할 수 있습니다. 코드의 다른 곳에서 객체에 액세스해야 할 경우 findobj 함수를 사용하여 Tag 값을 기반으로 객체를 검색할 수 있습니다.

UserData — 사용자 데이터

[] (디폴트 값) | 배열

사용자 데이터로, 임의의 MATLAB 배열로 지정됩니다. 예를 들어, 스칼라, 벡터, 행렬, 셀형 배열, 문자형 배열, table형 또는 구조체형으로 지정할 수 있습니다. 이 속성을 사용하여 객체에 임의의 데이터를 저장할 수 있습니다.

앱 디자이너에서 작업하는 경우 앱에서 데이터를 공유할 수 있도록 UserData 속성을 사용하는 대신 퍼블릭 또는 프라이빗 속성을 생성하십시오. 자세한 내용은 앱 디자이너로 만든 앱 내부에서 데이터 공유하기 항목을 참조하십시오.

버전 내역

R2019b에 개발됨

R2023a: TileArrangement 속성의 "vertical" 및 "horizontal" 옵션 쿼리

TileArrangement 속성 쿼리 시 가능한 두 개의 새로운 값은 "horizontal" 및 "vertical"입니다. 값 "horizontal"은 타일의 가로 누적에 해당하고 "vertical"은 타일의 세로 누적에 해당합니다.

타일 배열을 설정하려면 tiledlayout 함수를 호출할 때 arrangement 인수를 지정하십시오.

R2022b: 그리드 크기 변경 시 GridSizeChangedFcn 콜백을 실행할 수 있음

타일 형식 차트 레이아웃에서 GridSizeChangedFcn 콜백 함수를 정의합니다. 레이아웃의 GridSize 속성이 변경되면 콜백 함수가 실행됩니다. 이 콜백은 주로 "flow" 타일 배열을 사용하는 레이아웃에 유용합니다. 예를 들어 좌표축의 맨 아래 행에만 x축 눈금 레이블을 표시하는 콜백을 정의할 수 있습니다.

R2021a: 타일 간격 및 채우기 옵션이 새로운 이름과 동작을 가짐

타일 형식 차트 레이아웃을 만들 때 TileSpacing 속성과 Padding 속성 중 일부가 다른 결과를 제공하거나 새 이름을 갖습니다.

새로운 TileSpacing 옵션은 "loose", "compact", "tight", "none"입니다. 새로운 Padding 옵션은 "loose", "compact", "tight"입니다. 다음 표에서는 이전 옵션과 새로운 옵션 사이의 관계를 보여줍니다.

TileSpacing 변경 내용

이전 TileSpacing 옵션	R2021a TileSpacing 옵션	코드를 업데이트하는 방법
"normal"	"loose"	"normal"을 "loose"로 변경해 보십시오. "normal" 옵션은 더 이상 권장되지 않으나 계속 작동하며, 향후 제거할 계획이 없습니다.
"compact"	"compact"	변경할 필요가 없습니다.
해당 없음	"tight"	"tight"는 새로운 옵션입니다. 이 옵션은 이전 릴리스에서의 "none"과 결과가 같습니다.
"none"	"none"	"none" 옵션은 인접한 플롯 상자 사이의 모든 간격을 제거하며, 눈금 레이블이 이웃 플롯 상자와 중첩됩니다. 플롯 상자 간의 간격을 유지하려면 "none"을 "tight"로 변경하십시오.

Padding 변경 내용

이전 Padding 옵션	R2021a Padding 옵션	코드를 업데이트하는 방법
"normal"	"loose"	"normal"을 "loose"로 변경해 보십시오. "normal" 옵션은 더 이상 권장되지 않으나 계속 작동하며, 향후 제거할 계획이 없습니다.
"compact"	"compact"	변경할 필요가 없습니다.
"none"	"tight"	"none"을 "tight"로 변경해 보십시오. "none" 옵션은 더 이상 권장되지 않으나 계속 작동하며, 향후 제거할 계획이 없습니다.

참고 항목

tiledlayout | nexttile