MessageBoxExA 함수(winuser.h)

아티클
03/04/2024

메시지 상자를 만들고 표시하며 작동합니다. 메시지 상자에는 애플리케이션 정의 메시지와 제목과 미리 정의된 아이콘과 푸시 단추의 조합이 포함되어 있습니다. 단추는 시스템 사용자 인터페이스의 언어로 제공됩니다.

현재 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이면 기본 제목 Error 가 사용됩니다.

[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를 호출합니다.

함수가 성공하면 반환 값은 다음 메뉴 항목 값 중 하나입니다.

반환 코드/값	설명
IDABORT 3	중단 단추가 선택되었습니다.
IDCANCEL 2	취소 단추가 선택되었습니다.
IDCONTINUE 11	계속 단추가 선택되었습니다.
IDIGNORE 5	무시 단추가 선택되었습니다.
IDNO 7	아니요 단추가 선택되었습니다.
IDOK 1	확인 단추가 선택되었습니다.
IDRETRY 4	다시 시도 단추가 선택되었습니다.
IDTRYAGAIN 10	다시 시도 단추가 선택되었습니다.
IDYES 6	예 단추가 선택되었습니다.

설명

시스템 모달 메시지 상자를 사용하여 시스템이 메모리 부족임을 나타내는 경우 리소스 로드 시도가 실패할 수 있으므로 lpText 및 lpCaption 매개 변수가 가리키는 문자열을 리소스 파일에서 가져와서는 안 됩니다.

대화 상자가 있는 동안 메시지 상자를 만드는 경우 대화 상자에 대한 핸들을 hWnd 매개 변수로 사용합니다. hWnd 매개 변수는 대화 상자의 컨트롤과 같은 자식 창을 식별해서는 안 됩니다.

참고

winuser.h 헤더는 MESSAGEBoxEx를 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	winuser.h(Windows.h 포함)
라이브러리	User32.lib
DLL	User32.dll