다음을 통해 공유


MessageBoxExA 함수(winuser.h)

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

현재 MessageBoxExMessageBox 는 동일한 방식으로 작동합니다.

구문

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
단추가 선택되었습니다.

설명

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

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

참고

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

요구 사항

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

추가 정보

개념

대화 상자

MAKELANGID

MessageBeep

MessageBox

MessageBoxIndirect

기타 리소스

참조

SetForegroundWindow