datacursormode

데이터 커서 모드 활성화

설명

데이터 커서 모드를 사용하면 데이터팁을 대화형 방식으로 생성, 편집하여 데이터를 탐색할 수 있습니다. 데이터팁은 개별 데이터 점에 대한 정보를 표시하는 작은 텍스트 상자입니다. 데이터 커서 모드를 활성화하거나 비활성화하고 다른 기본적인 옵션을 설정하려면 datacursormode 함수를 사용합니다. 데이터팁의 모양과 동작을 제어하려면 DataCursorManager 객체를 반환한 후 사용하십시오.

데이터팁은 선 차트, 막대 차트, 히스토그램 차트, 곡면 차트 등 대부분의 차트에서 지원됩니다. 데이터팁이 지원되는 차트에는 대개 좌표축 도구 모음에 데이터팁 아이콘이 표시됩니다.

기본적으로 활성화되어 있는 내장된 좌표축 상호 작용을 사용하여 데이터를 대화형 방식으로 탐색할 수 있습니다. 예를 들어, 데이터 점 위에 커서를 놓아서 데이터팁을 잠시 표시하거나, 데이터 점을 클릭하여 데이터팁을 고정할 수 있습니다. 내장된 상호 작용을 사용할 때는 상호 작용 모드를 활성화할 필요가 없으며, 상호 작용 모드보다 반응 속도가 빠릅니다. 하지만 데이터 커서 모드를 활성화하면 데이터팁 동작을 사용자 정의할 수 있습니다. 내장된 상호 작용에 대한 자세한 내용은 차트 상호 작용 제어하기 항목을 참조하십시오.

생성

구문

datacursormode option

datacursormode

datacursormode(fig,option)

datacursormode(ax,option)

dcm = datacursormode

dcm = datacursormode(fig)

설명

datacursormode option은 현재 Figure에 있는 모든 좌표축에 대해 데이터 커서 모드를 설정합니다. 예를 들어 datacursormode on은 데이터 커서 모드를 활성화하고 datacursormode off는 데이터 커서 모드를 비활성화합니다.

데이터 커서 모드가 활성화되면 커서 또는 키보드를 사용하여 데이터팁을 만듭니다.

• 커서 — 플로팅된 데이터 점을 클릭합니다. 데이터팁을 여러 개 만들려면 Shift 키를 누른 상태에서 데이터 점을 선택합니다. 데이터팁을 다른 데이터 점으로 옮기려면 데이터팁이 있는 점을 끌어서 놓습니다.

• 키보드 — 일부 차트의 경우 현재 선택한 데이터팁을 다른 데이터 점으로 옮기려면 위쪽 화살표(↑), 아래쪽 화살표(↓), 왼쪽 화살표(←) 또는 오른쪽 화살표(→)를 누릅니다.

일부 내장된 상호 작용은 현재 상호 작용 모드에 관계없이 기본적으로 활성화된 상태로 유지됩니다. 데이터 커서 모드와는 독립적인 내장 데이터팁 상호 작용을 비활성화하려면 disableDefaultInteractivity 함수를 사용하십시오.

datacursormode는 데이터 커서 모드를 on과 off 간에 전환합니다.

datacursormode(fig,option)은 지정된 Figure에 있는 모든 좌표축에 대해 데이터 커서 모드를 설정합니다. 예를 들어, Figure fig에 있는 모든 좌표축에 대해 데이터 커서 모드를 활성화하려면 datacursormode(fig,'on')을 사용합니다.

datacursormode(ax,option)은 지정된 좌표축에 대해 데이터 커서 모드를 설정합니다. 예를 들어, 좌표축 ax에 대해 데이터 커서 모드를 활성화하려면 datacursormode(ax,'on')을 사용합니다. (R2023a 이후)

R2025a 이전: 앱 디자이너 또는 uifigure 함수를 사용하여 만든 앱에서는 이 구문을 사용하십시오.

dcm = datacursormode는 현재 Figure에 대해 DataCursorManager 객체를 만듭니다. 이 구문은 데이터 커서 모드, 데이터팁 디스플레이 스타일, 데이터팁 텍스트 형식을 사용자 지정할 때 유용합니다.

dcm = datacursormode(fig)는 지정된 Figure에 대한 DataCursorManager 객체를 만듭니다.

입력 인수

option — 데이터 커서 모드 옵션

'on' | 'off' | 'toggle'

데이터 커서 모드 옵션으로, 다음 값 중 하나로 지정됩니다.

• 'on' — 데이터 커서 모드를 활성화합니다.

• 'off' — 데이터 커서 모드를 비활성화합니다. 일부 내장된 상호 작용은 현재 상호 작용 모드에 관계없이 기본적으로 활성화된 상태로 유지됩니다. 데이터 커서 모드와는 독립적인 내장 데이터팁 상호 작용을 비활성화하려면 disableDefaultInteractivity 함수를 사용하십시오.

• 'toggle' — 데이터 커서 모드를 켜거나 끕니다. 예를 들어 데이터 커서 모드가 비활성화되어 있을 경우 'toggle'은 데이터 커서 모드를 활성화합니다. 이 옵션을 사용하는 것은 인수 없이 datacursormode를 호출하는 것과 동일합니다.

fig — 대상 Figure

Figure 객체

대상 Figure로, Figure 객체로 지정됩니다. 대상 Figure를 지정하면 현재 또는 미래의 모든 Axes의 자식에 대해 해당 모드가 설정됩니다.

ax — 대상 좌표축

Axes 객체

대상 좌표축으로, Axes 객체로 지정됩니다.

속성

참고

UpdateFcn을 제외하고 DataCursorManager 객체의 이러한 속성을 수정하면 MATLAB^®에서 Figure에 레거시 탐색 모드가 활성화됩니다. 자세한 내용은 enableLegacyExplorationModes를 참조하십시오.

Enable — 데이터 커서 모드 상태

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

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

SnapToDataVertex — 가장 가까운 데이터 점에 표시할지 여부

'on' (디폴트 값) | 'off'

가장 가까운 데이터 점에 표시할지 여부로, 다음 값 중 하나로 지정됩니다.

• 'on' — 가장 가까운 데이터 점에 데이터팁을 표시합니다. 가장 가까운 데이터 점은 차트의 유형에 따라 달라집니다. 예를 들어, 선 차트에서 가장 가까운 점은 지정된 위치로부터 가장 작은 유클리드 거리를 갖습니다.

• 'off' — (클릭한 위치가 데이터 점들 사이에 있더라도) 클릭한 위치에 데이터팁을 표시합니다.

참고

좌표축의 InteractionOptions 객체에 대한 DatatipsPlacementMethod 속성을 설정하면, 레거시 탐색 모드에 들어가지 않고도 이 기능을 동일하게 활용할 수 있습니다.

DisplayStyle — 데이터팁 디스플레이 스타일

'datatip' (디폴트 값) | 'window'

데이터팁 디스플레이 스타일로, 다음 값 중 하나로 지정됩니다.

• 'datatip' — 데이터팁을 데이터 값에 연결된 작은 텍스트 상자로 표시합니다. 데이터팁을 여러 개 만들려면 Shift 키를 누른 상태에서 데이터 점을 선택합니다. 데이터 커서 모드를 비활성화해도 기존 데이터팁은 차트에 남아 있습니다.

• 'window' — 데이터팁을 Figure 내의 이동 가능한 창 안에 표시합니다. 디스플레이 스타일이 'window'이면 한 번에 하나의 데이터팁만 표시할 수 있습니다. 데이터 커서 모드를 비활성화하면 창이 닫힙니다.

Interpreter — 텍스트 인터프리터

'tex' (디폴트 값) | 'latex' | 'none'

텍스트 인터프리터로, 다음 값 중 하나로 지정됩니다.

• 'tex' — TeX 마크업의 서브셋을 사용하여 문자를 해석합니다.

• 'latex' — LaTeX 마크업을 사용하여 문자를 해석합니다.

• 'none' — 리터럴 문자를 표시합니다.

TeX 마크업

기본적으로 MATLAB은 TeX 마크업의 서브셋을 지원합니다. TeX 마크업을 사용하여 위 첨자와 아래 첨자를 추가하고, 글꼴 유형과 색을 수정하며, 텍스트에 특수 문자를 포함시킬 수 있습니다.

수정자는 텍스트의 끝까지 적용됩니다. 단, 위 첨자와 아래 첨자는 바로 다음에 오는 문자나 중괄호 안에 있는 문자만 수정합니다. 인터프리터를 'tex'으로 설정한 경우 지원되는 수정자는 다음과 같습니다.

수정자	설명	예
^{ }	위 첨자	'text^{superscript}'
_{ }	아래 첨자	'text_{subscript}'
\bf	굵은 글꼴	'\bf text'
\it	기울임꼴	'\it text'
\sl	오블리크 글꼴(일반적으로 기울임꼴과 같음)	'\sl text'
\rm	보통 글꼴	'\rm text'
\fontname{specifier}	글꼴 이름 — specifier를 글꼴 이름으로 바꿉니다. 이 수정자는 다른 수정자와 함께 사용할 수 있습니다.	'\fontname{Courier} text'
\fontsize{specifier}	글꼴 크기 — specifier를 숫자형 스칼라 값으로 바꿉니다(단위: 포인트).	'\fontsize{15} text'
\color{specifier}	글꼴 색 — specifier를 red, green, yellow, magenta, blue, black, white, gray, darkGreen, orange, lightBlue 색 중 하나로 바꿉니다.	'\color{magenta} text'
\color[rgb]{specifier}	사용자 지정 글꼴 색 — specifier를 요소를 3개 가진 RGB 3색으로 바꿉니다.	'\color[rgb]{0,0.5,0.5} text'

다음 표에는 'tex' 인터프리터에 사용할 수 있는 특수 문자가 나열되어 있습니다.

문자 시퀀스	기호	문자 시퀀스	기호	문자 시퀀스	기호
\alpha	α	\upsilon	υ	\sim	~
\angle	∠	\phi		\leq	≤
\ast	*	\chi	χ	\infty	∞
\beta	β	\psi	ψ	\clubsuit	♣
\gamma	γ	\omega	ω	\diamondsuit	♦
\delta	δ	\Gamma	Γ	\heartsuit	♥
\epsilon	ϵ	\Delta	Δ	\spadesuit	♠
\zeta	ζ	\Theta	Θ	\leftrightarrow	↔
\eta	η	\Lambda	Λ	\leftarrow	←
\theta	θ	\Xi	Ξ	\Leftarrow	⇐
\vartheta	ϑ	\Pi	Π	\uparrow	↑
\iota	ι	\Sigma	Σ	\rightarrow	→
\kappa	κ	\Upsilon	ϒ	\Rightarrow	⇒
\lambda	λ	\Phi	Φ	\downarrow	↓
\mu	µ	\Psi	Ψ	\circ	º
\nu	ν	\Omega	Ω	\pm	±
\xi	ξ	\forall	∀	\geq	≥
\pi	π	\exists	∃	\propto	∝
\rho	ρ	\ni	∍	\partial	∂
\sigma	σ	\cong	≅	\bullet	•
\varsigma	ς	\approx	≈	\div	÷
\tau	τ	\Re	ℜ	\neq	≠
\equiv	≡	\oplus	⊕	\aleph	ℵ
\Im	ℑ	\cup	∪	\wp	℘
\otimes	⊗	\subseteq	⊆	\oslash	∅
\cap	∩	\in	∈	\supseteq	⊇
\supset	⊃	\lceil	⌈	\subset	⊂
\int	∫	\cdot	·	\o	ο
\rfloor	♣	\neg	¬	\nabla	∇
\lfloor	⌊	\times	x	\ldots	...
\perp	⊥	\surd	√	\prime	´
\wedge	∧	\varpi	ϖ	\0	∅
\rceil	⌉	\rangle	〉	\mid	|
\vee	∨	\langle	〈	\copyright	©

LaTeX 마크업

LaTeX 마크업을 사용하려면 인터프리터를 'latex'으로 설정하십시오. 텍스트는 달러 기호로 감쌉니다. 예를 들어, 인라인 모드의 경우 '$\int_1^{20} x^2 dx$', 디스플레이 모드의 경우 '$$\int_1^{20} x^2 dx$$'와 같이 사용하십시오.

표시되는 텍스트에 디폴트 LaTeX 글꼴 스타일이 사용됩니다. 글꼴 스타일을 변경하려면 LaTeX 마크업을 사용하십시오.

LaTeX 인터프리터와 함께 사용할 수 있는 최대 텍스트 크기는 1,200자입니다. 여러 라인으로 된 텍스트의 경우에는 라인당 약 10자씩 줄어듭니다.

MATLAB은 대부분의 표준 LaTeX 수식 모드 명령을 지원합니다. 자세한 내용은 지원되는 LaTeX 명령 항목을 참조하십시오. TeX 및 LaTeX을 사용하는 예제는 차트 텍스트에 들어 있는 그리스 문자나 특수 문자 항목을 참조하십시오.

UpdateFcn — 데이터팁 텍스트의 형식을 지정하는 콜백 함수

[] (디폴트 값) | 함수 핸들

데이터팁 텍스트의 형식을 지정하는 콜백 함수로, 함수 핸들로 지정됩니다.

이 속성을 사용하여 데이터팁 내용의 형식을 지정할 수 있습니다. MATLAB은 다음 두 개의 인수를 콜백 함수에 전달합니다.

• empty — 빈 인수. 함수에서 이 인수를 물결표 문자(~)로 바꿔서 이 인수가 사용되지 않음을 나타낼 수 있습니다.

• info — 데이터팁에 대한 정보를 포함하는 구조체. info 인수에는 두 개의 필드 Target과 Position이 있습니다. Target 필드는 DataTipTemplate 속성을 갖는 객체를 포함합니다. Position 필드는 데이터팁의 좌표를 포함합니다.

함수는 MATLAB 경로에 있거나 현재 폴더 내에 있어야 합니다. 또는 데이터팁 상황별 메뉴에서 업데이트 함수 > 파일에서 선택을 선택하여 MATLAB 경로에 있지 않은 함수를 선택할 수도 있습니다.

콜백에 대한 자세한 내용은 그래픽스 객체에 대한 콜백 만들기 항목을 참조하십시오.

Figure — figure 객체

읽기 전용: Figure 객체

읽기 전용 속성입니다.

데이터팁이 나타나는 Figure 객체.

객체 함수

참고

DataCursorManager 객체에 대해 이 객체 함수를 호출하면 MATLAB에서 Figure에 레거시 탐색 모드가 활성화됩니다. 자세한 내용은 enableLegacyExplorationModes를 참조하십시오.

getCursorInfo

getCursorInfo 함수는 Figure에 있는 각 데이터팁의 대상 객체와 좌표를 반환합니다. data cursor manager 객체 dcm에 대해 info = getCursorInfo(dcm)을 호출하면 다음 필드를 포함하는 벡터 info가 반환됩니다. Target — DataTipTemplate 속성을 갖는 객체(예: Line, Histogram, Surface, FunctionLine 등). Position — 데이터팁의 좌표. 좌표는 좌표축 유형에 따라 다르게 해석됩니다. 예를 들어, 카테시안 좌표축의 좌표는 데이터와 동일한 단위를 갖는 x, y, z입니다. DataIndex — 플로팅된 데이터의 인덱스. 예를 들어, 카테시안 좌표축 세트에 플로팅된 2차원 객체의 데이터는 XData 속성과 YData 속성에 포함되어 있습니다. 참고 일부 대상 객체의 경우 info 구조체에 DataIndex 필드가 포함되지 않습니다.

예제

이동 가능한 창 안에 데이터팁 표시하기

데이터를 플로팅하고 DataCursorManager 객체를 생성합니다.

x = linspace(0,5,30);
y = exp(x);
scatter(x,y)
dcm = datacursormode;

데이터 커서 모드를 활성화하고 DisplayStyle 속성을 'window'로 설정하여 이동 가능한 창 안에 데이터팁 내용을 표시합니다. 그런 다음 데이터 점을 클릭하여 데이터팁을 만듭니다. 창 제목을 끌어서 데이터팁 창을 이동할 수 있습니다.

dcm.Enable = 'on';
dcm.DisplayStyle = 'window';

데이터팁 텍스트 사용자 지정하기

데이터팁 정보를 받아서 사용자 지정 텍스트를 반환하는 콜백 함수를 정의합니다. 사용자 지정 텍스트를 string형으로 반환합니다. 여기서는 string형이 순서가 지정된 좌표 쌍을 포함합니다. 함수를 displayCoordinates.m이라는 프로그램 파일로 저장합니다.

function txt = displayCoordinates(~,info)
    x = info.Position(1);
    y = info.Position(2);
    myDatatipText = "(%s, %s)";
    txt = sprintf(myDatatipText, num2str(x), num2str(y));
end

데이터를 플로팅하고, 커서 모드를 활성화하고, UpdateFcn 속성을 콜백 함수로 설정합니다.

x = 1:10;
y = x.^2;
scatter(x,y)

dcm = datacursormode;
dcm.Enable = 'on';
dcm.UpdateFcn = @displayCoordinates;

그런 다음 데이터 점을 클릭하여 데이터팁을 만듭니다.

팁

• 대개 데이터팁에는 선택한 데이터 점의 좌표가 표시됩니다. 그러나 일부 유형의 차트에서는 데이터팁에 특화된 정보가 표시됩니다. 예를 들어, histogram 함수를 사용하여 만든 히스토그램은 관측값 개수와 Bin 경계값을 항목별로 나눈 데이터팁을 표시합니다.

대체 기능

좌표축 도구 모음

일부 차트의 경우 좌표축 도구 모음에서 데이터팁 아이콘을 클릭하여 데이터 커서 모드를 활성화합니다.

프로그래밍 방식 워크플로

데이터팁을 프로그래밍 방식으로 만들고 사용자 지정하려면 datatip 함수와 dataTipTextRow 함수를 사용하십시오. 자세한 내용은 사용자 지정 데이터팁 생성하기 항목을 참조하십시오.

버전 내역

R2006a 이전에 개발됨

R2025a: 지정된 좌표축에 대해 데이터 커서 모드 설정

좌표축을 datacursormode의 첫 번째 입력값으로 지정하여 좌표축에 대해 데이터 커서 모드를 설정할 수 있습니다. 좌표축에 대해 데이터 커서 모드를 설정할 경우 함수는 DataCursorManager 객체를 반환하지 않습니다. 이전에는 앱 디자이너 또는 uifigure 함수를 사용하여 만든 앱에서만 좌표축에 대해 데이터 커서 모드를 설정할 수 있었습니다.

R2023a: 앱에 지정된 좌표축에 대해 데이터 커서 모드 설정

앱 디자이너 또는 uifigure 함수를 사용하여 만든 앱의 경우 좌표축을 datacursormode의 첫 번째 입력값으로 지정하여 좌표축에 대해 데이터 커서 모드를 설정할 수 있습니다. 좌표축에 대해 데이터 커서 모드를 설정할 경우 함수는 DataCursorManager 객체를 반환하지 않습니다.

R2018b: 기본적으로 활성화된 데이터팁으로 데이터 탐색

기본적으로 활성화되어 있는 내장 좌표축 상호 작용을 사용하여 데이터를 대화형 방식으로 탐색합니다. 예를 들어, 데이터 커서 모드를 활성화하지 않고도 데이터 점 위에 커서를 올리면 데이터팁을 볼 수 있습니다. 자세한 내용은 차트 상호 작용 제어하기 항목을 참조하십시오.

이전에는 기본적으로 활성화된 좌표축 상호 작용이 없었습니다.

참고 항목

함수

• dataTipInteraction | datatip

도움말 항목

• 플로팅된 데이터를 대화형 방식으로 탐색하고 분석하기
• 차트 상호 작용 제어하기
• 사용자 지정 데이터팁 생성하기