msgbox

메시지 대화 상자 만들기

구문

f = msgbox(message)

f = msgbox(message,title)

f = msgbox(message,title,icon)

f = msgbox(message,title,"custom",icondata,iconcmap)

f = msgbox(___,createmode)

설명

참고

앱 디자이너 및 uifigure 함수로 만든 앱에서는 uialert가 추가적인 사용자 지정 옵션을 제공하기 때문에 msgbox보다 권장됩니다.

f = msgbox(message)는 적절한 크기의 Figure에 맞게 message를 자동으로 줄 바꿈하는 메시지 대화 상자를 만듭니다.

여러 앱 창, MATLAB^® 데스크탑 또는 Simulink^® 위에 메시지 대화 상자를 표시하고, 대화 상자에 응답하기 전에 계속해서 앱 창, MATLAB 데스크탑 또는 Simulink와 상호 작용할 수 있도록 하려면 이 함수를 사용하십시오.

f = msgbox(message,title)은 메시지 상자의 제목을 지정합니다.

f = msgbox(message,title,icon)은 메시지 대화 상자에 표시할 미리 정의된 아이콘을 지정합니다.

f = msgbox(message,title,"custom",icondata,iconcmap)은 메시지 대화 상자에 포함할 사용자 지정 아이콘을 지정합니다. icondata는 해당 아이콘을 정의하는 이미지 데이터입니다. iconcmap은 이미지에 사용하는 컬러맵입니다. icondata가 트루컬러 이미지 배열인 경우 iconcmap을 지정할 필요가 없습니다.

f = msgbox(___,createmode)는 대화 상자에 대한 창 모드를 지정합니다. 또는 message에 대한 창 모드와 인터프리터를 지정하는 구조체형 배열을 지정할 수 있습니다.

예제

단순 메시지 대화 상자

메시지 대화 상자에 표시할 텍스트를 지정합니다.

f = msgbox("Operation Completed");

줄 바꿈을 사용한 메시지 대화 상자 텍스트

string형 배열을 사용하여 메시지 대화 상자 텍스트를 지정합니다.

f = msgbox(["Operation";"Completed"]);

제목이 있는 메시지 대화 상자

메시지 대화 상자 텍스트를 지정하고 대화 상자의 제목을 Success로 지정합니다.

f = msgbox("The operation has been successfully completed","Success");

내장 아이콘을 사용하는 메시지 대화 상자

제목이 "Error"인 메시지 대화 상자의 오류 메시지에 내장 오류 아이콘을 포함합니다.

f = msgbox("Invalid Value","Error","error");

트루컬러 사용자 지정 아이콘을 사용하는 메시지 대화 상자

RGB 이미지를 작업 공간으로 읽어 옵니다. 그런 다음 그 이미지를 대화 상자의 사용자 지정 아이콘으로 지정합니다.

myicon = imread("landOcean.jpg");
h = msgbox("Operation Completed","Success","custom",myicon);

인덱스 색상 아이콘을 사용하는 메시지 대화 상자

이미지 데이터와 컬러맵을 작업 공간으로 읽어 옵니다.

[icondata,iconcmap] = imread("trees.tif"); 

사용자 지정 아이콘이 포함된 메시지 대화 상자를 만듭니다.

h = msgbox("Operation Completed", ...
         "Success","custom",icondata,iconcmap);

서로 다른 컬러맵을 지정하여 이미지 색을 조정합니다. 예를 들면 MATLAB의 내장 컬러맵인 summer를 지정합니다.

h = msgbox("Operation Completed","Success","custom", ...
          icondata,summer);

모달 메시지 대화 상자

사용자가 메시지 대화 상자를 조작할 때까지 메시지 대화 상자에서 MATLAB 실행을 차단하도록 msgbox에 대한 호출을 uiwait로 래핑(Wrapping)하는 모달 메시지 대화 상자를 만듭니다.

uiwait(msgbox("Operation Completed","Success","modal"));

TeX 형식의 메시지를 사용하는 모달 메시지 대화 상자

사용자가 다른 창과 상호 작용하려면 OK를 클릭해야 하고 MATLAB이 메시지 텍스트를 TeX 형식으로 해석한다고 규정하는 구조체를 만듭니다.

CreateStruct.Interpreter = 'tex';
CreateStruct.WindowStyle = 'modal';

메시지 대화 상자를 만듭니다.

h = msgbox("Z = X^2 + Y^2","Value",CreateStruct);

입력 인수

message — 대화 상자 텍스트

문자형 벡터 | 문자형 벡터로 구성된 셀형 배열 | string형 배열

대화 상자 텍스트로, 문자형 벡터, 문자형 벡터로 구성된 셀형 배열 또는 string형 배열로 지정됩니다.

예: "Operation Completed"

예: ["Operation";"Completed"]

title — 제목

문자형 벡터 | string형 스칼라

제목으로, 문자형 벡터 또는 string형 스칼라로 지정됩니다.

예: "Success"

icon — 아이콘

"none" (디폴트 값) | "help" | "warn" | "error" | "custom"

아이콘으로, "help", "warn" 또는 "error"나 "none"으로 지정됩니다.

다음 표에는 값과 해당 아이콘이 나와 있습니다.

값	아이콘
"help"
"warn"
"error"
"none"	아이콘이 표시되지 않습니다.

icondata — 이미지 배열

m×n 배열 | m×n×3 트루컬러 이미지 배열

이미지 배열로, m×n 배열 또는 m×n×3 트루컬러 이미지 배열로 지정됩니다. imread를 사용하여 파일에서 이미지 배열을 가져올 수도 있습니다.

데이터형: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

iconcmap — 컬러맵

RGB 3색으로 구성된 3열 행렬

컬러맵으로, RGB 3색으로 구성된 3열 행렬로 지정됩니다. RGB 3색은 요소를 3개 가진 행 벡터로, 각 요소는 색을 구성하는 빨간색, 녹색, 파란색의 농도를 지정합니다. 농도의 범위는 [0, 1]이어야 합니다.

데이터형: single | double

createmode — 창 모드

"non-modal" (디폴트 값) | "modal" | "replace" | 구조체형 배열

창 모드로, "non-modal", "modal", "replace" 또는 구조체형 배열로 지정됩니다.

• createmode가 "non-modal"이면 MATLAB은 지정된 파라미터를 사용하여 새로운 비모달 메시지 대화 상자를 만듭니다. 같은 title이 있는 기존 메시지 상자는 그대로 유지됩니다.

• createmode가 "modal"이면 MATLAB은 마지막으로 만들거나 클릭한 지정된 title의 기존 메시지 대화 상자를 지정된 모달 대화 상자로 바꿉니다. MATLAB은 같은 제목의 다른 모든 메시지 상자를 삭제합니다. 바꾼 메시지 상자는 모달이거나 비모달 상자일 수 있습니다.

• createmode가 "replace"이면 MATLAB은 지정된 title이 있는 메시지 상자 중에서 마지막으로 만들거나 클릭한 메시지 상자를 지정된 비모달 메시지 상자로 바꿉니다. MATLAB은 같은 제목의 다른 모든 메시지 상자를 삭제합니다. 바꾼 메시지 상자는 모달이거나 비모달 상자일 수 있습니다.

• createmode가 구조체형 배열이면 필드 WindowStyle과 필드 Interpreter를 가져야 합니다. WindowStyle 필드의 값은 "non-modal", "modal" 또는 "replace"여야 합니다. Interpreter 필드의 값은 "tex" 또는 "none"이어야 합니다. Interpreter 값이 "tex"이면 MATLAB은 message 값을 TeX로 해석합니다. Interpreter의 디폴트 값은 "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	©

출력 인수

f — Figure 객체

Figure 객체

대화 상자에 대한 Figure 객체입니다. f를 사용하여 대화 상자의 속성을 쿼리하고 수정할 수 있습니다.

세부 정보

모달 대화 상자

모달 대화 상자에서는 대화 상자 조작이 끝나기 전에 다른 MATLAB 창과 상호 작용을 할 수 없습니다.

비모달 대화 상자

비모달 대화 상자에서는 대화 상자의 조작이 끝나기 전에 다른 MATLAB 창과 상호 작용을 할 수 있습니다. 비모달 대화 상자는 일반 대화 상자라고도 합니다.

팁

• errordlg, msgbox, warndlg 중 하나를 사용하여 생성된 모달 대화 상자는 이러한 함수를 사용하여 생성된 기존의 대화 상자 중 이름이 동일한 대화 상자를 모두 대체합니다.

• 모달 대화 상자가 활성 상태일 때도 프로그램은 계속 실행됩니다. 사용자가 모달 대화 상자를 조작할 때까지 MATLAB 프로그램 실행을 차단하려면 uiwait 함수를 사용하십시오.

• 단일 창 앱 디자이너 또는 uifigure 기반 앱에서 모달 알림 대화 상자를 만들려면 대신 uialert 함수를 사용하십시오.

버전 내역

R2006a 이전에 개발됨

참고 항목

uialert | errordlg | helpdlg | warndlg