MessageBox(A)

MessageBox(A)

메시지 박스를 표시합니다.메시지 박스에는 어플리케이션 정의의 메세지와 캡션 문자열, 및 정의가 끝난 아이콘과 누르는 보턴이 표시됩니다.

int MessageBoxA(
    HWND   hWnd,       // 오너 윈도우의 핸들
    PCTSTR pszText,    // 표시 문자열
    PCTSTR pszCaption, // 캡션 바의 표시 문자열
    UINT   uType       // 메시지 박스의 타입
);

USER32.DLL

인수

hWnd

오너 윈도우의 핸들을 지정합니다.0 (NULL) (을)를 지정했을 경우, 메시지 박스는 오너 윈도우를 가지지 않습니다.

pszText

메시지 박스중에 표시하는 문자열에의 포인터를 지정합니다.

pszCaption

메시지 박스의 캡션(타이틀) 바에 표시하는 문자열에의 포인터를 지정합니다.0 (NULL) (을)를 지정하면, 디폴트의 캡션(“에러”)이 표시됩니다.

uType

표시하는 버튼의 종류를 지정합니다.이것에는 이하의 값의 어느쪽이든을 지정할 수 있습니다.

0x00000000 (MB_OK)

［OK］

0x00000001 (MB_OKCANCEL)

［OK］［캔슬］

0x00000002 (MB_ABORTRETRYIGNORE)

［중지］［재시행］［무시］

0x00000003 (MB_YESNOCANCEL)

［네］［아니오］［캔슬］

0x00000004 (MB_YESNO)

［네］［아니오］

0x00000005 (MB_RETRYCANCEL)

［재시행］［캔슬］

0x00000006 (MB_CANCELTRYCONTINUE)

Windows 2000/XP： ［캔슬］［한번 더］［계속］

0x00004000 (MB_HELP)

Windows 9x/NT4.0 이후： ［헬프］

이 버튼 또는 [F1] 키가 밀리면, 오너 윈도우에 WM_HELP 메세지가 보내집니다.

한층 더 아이콘 플래그로서 이하의 값의 어느쪽이든을 조합해 지정할 수 있습니다.

0x00000010 (MB_ICONSTOP, MB_ICONERROR, MB_ICONHAND)

정지의 아이콘

0x00000020 (MB_ICONQUESTION)

물음표의 아이콘

0x00000030 (MB_ICONEXCLAMATION, MB_ICONWARNING)

감탄부의 아이콘

0x00000040 (MB_ICONINFORMATION, MB_ICONASTERISK)

송풍에 「i」의 아이콘

디폴트 버튼을 지정하는데, 이하의 몇개의 값을 조합할 수 있습니다.이러한 모두 지정하지 않았던 경우에는, 최초의 버튼이 디폴트가 됩니다.

0x00000000 (MB_DEFBUTTON1)

최초의 버튼을 디폴트로 한다

0x00000100 (MB_DEFBUTTON2)

2번째의 버튼을 디폴트로 한다

0x00000200 (MB_DEFBUTTON3)

3번째의 버튼을 디폴트로 한다

0x00000300 (MB_DEFBUTTON4)

4번째의 버튼을 디폴트로 한다

그 밖에도 이하의 값을 조합할 수 있습니다.

0x00010000 (MB_SETFOREGROUND)

foreground로 한다

0x00040000 (MB_TOPMOST)

맨 앞면윈도우(다른 윈도우에 숨지 않는다)로 한다

반환값

성공하면, 밀린 버튼에 의해서, 이하의 몇개의 값이 돌아갑니다.

1 (IDOK)

［OK］

2 (IDCANCEL)

［캔슬］

3 (IDABORT)

［중지］

4 (IDRETRY)

［재시행］

5 (IDIGNORE)

［무시］

6 (IDYES)

［네］

7 (IDNO)

［아니오］

10 (IDTRYAGAIN)

［한번 더］

11 (IDCONTINUE)

［계속］

캔슬 버튼이 표시되고 있을 때［ESC］키 또는 우상의［×］버튼을 누르면, 캔슬 버튼이 밀렸다고 판단됩니다.

함수가 실패하면0하지만 돌아갑니다.확장 에러 정보를 취득하려면 , GetLastError함수를 사용합니다.

대응 정보

Windows 95 이후 / Windows NT 3.1 이후