메시지 상자를 만들고, 표시하고, 작동합니다. 메시지 상자에는 애플리케이션에서 정의한 메시지와 제목과 미리 정의된 아이콘과 누름 단추의 조합이 포함되어 있습니다. 단추는 시스템 사용자 인터페이스의 언어로 제공됩니다.
현재 MessageBoxEx 및 MessageBox 동일한 방식으로 작동합니다.
통사론
int MessageBoxExA(
[in, optional] HWND hWnd,
[in, optional] LPCSTR lpText,
[in, optional] LPCSTR lpCaption,
[in] UINT uType,
[in] WORD wLanguageId
);
매개 변수
[in, optional] hWnd
형식: HWND
만들 메시지 상자의 소유자 창에 대한 핸들입니다. 이 매개 변수가 NULL
[in, optional] lpText
형식: LPCTSTR
표시할 메시지입니다.
[in, optional] lpCaption
형식: LPCTSTR
대화 상자 제목입니다. 이 매개 변수가 NULL
[in] uType
형식: UINT
대화 상자의 내용과 동작입니다. 지원되는 플래그에 대한 자세한 내용은 MessageBox참조하세요.
[in] wLanguageId
형식: WORD
메시지 상자 단추에 표시되는 텍스트의 언어입니다. 값 0을 지정하면 단추 텍스트가 기본 시스템 언어로 표시됩니다. 이 매개 변수가 MAKELANGID(LANG_NEUTRAL, SUBLANG_NEUTRAL)경우 호출 스레드와 연결된 현재 언어가 사용됩니다.
현재 언어 이외의 언어를 지정하려면 MAKELANGID 매크로를 사용하여 이 매개 변수를 만듭니다. 자세한 내용은 MAKELANGID참조하세요.
반환 값
형식: int
메시지 상자에 취소 단추가 있는 경우 ESC 키를 누르거나 취소 단추를 선택한 경우 함수는 IDCANCEL 값을 반환합니다. 메시지 상자에 취소 단추가 없으면 MB_OK 단추가 없는 한 ESC를 누르면 효과가 없습니다. MB_OK 단추가 표시되고 사용자가 ESC를 누르면 반환 값은 IDOK
함수가 실패하면 반환 값은 0입니다. 확장 오류 정보를 얻으려면 GetLastError호출합니다.
함수가 성공하면 반환 값은 다음 메뉴 항목 값 중 하나입니다.
| 반환 코드/값 | 묘사 |
|---|---|
|
중단 단추가 선택되었습니다. |
|
취소 단추가 선택되었습니다. |
|
계속 단추가 선택되었습니다. |
|
무시 단추가 선택되었습니다. |
|
없음 단추가 선택되었습니다. |
|
확인 단추가 선택되었습니다. |
|
다시 시도 단추가 선택되었습니다. |
|
다시 시도 단추가 선택되었습니다. |
|
예 단추가 선택되었습니다. |
발언
시스템 모달 메시지 상자를 사용하여 시스템이 메모리가 부족함을 나타내는 경우 리소스 로드 시도가 실패할 수 있으므로 lpText 및 lpCaption 매개 변수가 가리키는 문자열을 리소스 파일에서 가져와서는 안 됩니다.
대화 상자가 있는 동안 메시지 상자를 만드는 경우 대화 상자에 대한 핸들을 hWnd 매개 변수로 사용합니다. hWnd 매개 변수는 대화 상자의 컨트롤과 같은 자식 창을 식별하면 안 됩니다.
메모
winuser.h 헤더는 UNICODE 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 MessageBoxEx를 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입대한
요구 사항
| 요구 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 2000 Professional [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows 2000 Server [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | winuser.h(Windows.h 포함) |
| 라이브러리 | User32.lib |
| DLL | User32.dll |
참고 항목
개념
MAKELANGID
messageBox
messageBoxIndirect
기타 리소스
참조
SetForegroundWindow