IConsole::MessageBox 메서드(mmc.h)
메시지 상자를 표시합니다.
구문
HRESULT MessageBox(
[in] LPCWSTR lpszText,
[in] LPCWSTR lpszTitle,
[in] UINT fuStyle,
[out] int *piRetval
);
매개 변수
[in] lpszText
표시할 메시지를 포함하는 null로 끝나는 문자열에 대한 포인터입니다.
[in] lpszTitle
메시지 상자 제목에 사용되는 null로 끝나는 문자열에 대한 포인터입니다. 이 매개 변수가 NULL이면 기본 제목 "Error"가 사용됩니다.
[in] fuStyle
메시지 상자의 내용과 동작을 결정하는 비트 플래그 집합을 지정하는 값입니다. 이 매개 변수는 Windows API MessageBox에 대한 설명서에서 가져온 다음 플래그 그룹의 플래그 조합일 수 있습니다.
메시지 상자에 표시되는 단추를 나타내려면 다음 플래그 중 하나를 지정합니다.
MB_ABORTRETRYIGNORE
메시지 상자에는 중단, 다시 시도 및 무시의 세 가지 단추가 포함되어 있습니다.
MB_OK
메시지 상자에는 확인이라는 하나의 단추가 포함되어 있습니다. 이것이 기본값입니다.
MB_OKCANCEL
메시지 상자에는 확인 및 취소라는 두 개의 단추가 있습니다.
MB_RETRYCANCEL
메시지 상자에는 다시 시도 및 취소라는 두 개의 단추가 있습니다.
MB_YESNO
메시지 상자에는 예 및 아니요라는 두 개의 단추가 있습니다.
MB_YESNOCANCEL
메시지 상자에는 예, 아니요 및 취소라는 세 개의 단추가 있습니다.
메시지 상자에 표시되는 아이콘을 나타내려면 다음 플래그 중 하나를 지정합니다.
MB_ICONEXCLAMATION, MB_ICONWARNING
메시지 상자에 느낌표 아이콘이 나타납니다.
MB_ICONINFORMATION, MB_ICONASTERISK
원 안에 "I"로 구성된 아이콘이 메시지 상자에 나타납니다.
MB_ICONQUESTION
메시지 상자에 물음표 아이콘이 나타납니다.
MB_ICONSTOP
MB_ICONERROR, MB_ICONHAND
메시지 상자에 중지 기호 아이콘이 나타납니다.
기본 단추를 나타내려면 다음 플래그 중 하나를 지정합니다.
MB_DEFBUTTON1
이 그룹의 다른 플래그 중 하나가 기본값으로 지정되지 않는 한 첫 번째 단추는 기본 단추입니다.
MB_DEFBUTTON2
두 번째 단추가 기본 단추입니다.
MB_DEFBUTTON3
세 번째 단추가 기본 단추입니다.
MB_DEFBUTTON4
네 번째 단추가 기본 단추입니다.
대화 상자의 형식을 나타내려면 다음 플래그 중 하나를 지정합니다.
MB_APPLMODAL
사용자는 현재 창에서 작업을 계속하기 전에 메시지 상자에 응답해야 합니다. 그러나 사용자는 다른 애플리케이션의 창으로 이동하여 해당 창에서 작업할 수 있습니다. MB_SYSTEMMODAL 또는 MB_TASKMODAL 지정되지 않은 경우 기본값은 MB_APPLMODAL.
MB_SYSTEMMODAL
모든 애플리케이션에는 사용자가 messagebox에 응답할 때까지 일시 중단 됩니다. 시스템 모달 메시지 상자는 사용자에게 즉각적인 주의가 필요하고 드물게 사용해야 하는 심각하고 잠재적으로 손상될 수 있는 오류를 알리는 데 사용됩니다.
MB_TASKMODAL
MB_APPLMODAL 유사하지만 MFC(Microsoft Foundation Classes) 애플리케이션 내에서는 유용하지 않습니다. 이 플래그는 사용 가능한 창 핸들이 없는 호출 애플리케이션 또는 라이브러리용으로 예약되어 있습니다.
또한 다음 플래그를 지정할 수 있습니다.
MB_DEFAULT_DESKTOP_ONLY
현재 입력을 수신하는 데스크톱은 기본 데스크톱이어야 합니다. 그렇지 않으면 함수가 실패합니다. 기본 데스크톱은 사용자가 로그온한 후 애플리케이션이 실행되는 데스크톱입니다.
MB_HELP
메시지 상자에 도움말 단추를 추가합니다. 도움말 단추를 선택하거나 F1 키를 누르면 도움말 이벤트가 생성됩니다.
MB_RIGHT
텍스트가 오른쪽 정렬됩니다.
MB_RTLREADING
히브리어 및 아랍어 시스템에 대한 오른쪽에서 왼쪽 읽기 순서를 사용하여 메시지 및 캡션 텍스트를 표시합니다.
MB_SETFOREGROUND
메시지 상자가 포그라운드 창이 됩니다. 내부적으로 운영 체제는 메시지 상자에 대해 SetForegroundWindow 함수를 호출합니다.
MB_TOPMOST
메시지 상자는 WS_EX_TOPMOST 창 스타일로 만들어집니다.
MB_SERVICE_NOTIFICATION
호출자는 이벤트의 사용자에 게 알리는 서비스. 사용자가 없는 컴퓨터에 로그온 하는 경우에 현재 활성 바탕 화면에 메시지 상자를 표시 하는 함수입니다.
이 플래그를 사용하는 방법에 대한 자세한 내용은 MessageBox 함수를 참조하세요.
MB_SERVICE_NOTIFICATION_NT3x
이 값은 이전 버전의 Windows에 대해 MB_SERVICE_NOTIFICATION 대해 정의된 값에 해당합니다.
[out] piRetval
반환 값에 대한 포인터입니다.
반환 값
이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.
설명
스냅인에 포커스가 없을 때 발생하는 오류를 표시하는 에 MessageBox를 사용하면 안 됩니다. 일반적 으로
MessageBox 는 오류가 사용자에게 주의를 기울여야 하는 경우와 오류에도 불구하고 결과 창에 유용한 정보가 포함된 경우에만 사용해야 합니다.
대부분의 경우 MMC 메시지 OCX 컨트롤은 오류 메시지를 표시하는 보다 적절한 방법입니다. 자세한 내용은 MMC 메시지 OCX 컨트롤 사용을 참조하세요.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista |
| 지원되는 최소 서버 | Windows Server 2008 |
| 대상 플랫폼 | Windows |
| 헤더 | mmc.h |
| DLL | Mmcndmgr.dll |