AfxMessageBox
화면에게 메시지 상자를 표시합니다.
int AfxMessageBox(
LPCTSTR lpszText,
UINT nType = MB_OK,
UINT nIDHelp = 0
);
int AFXAPI AfxMessageBox(
UINT nIDPrompt,
UINT nType = MB_OK,
UINT nIDHelp = (UINT
) -1
);
매개 변수
lpszText
메시지 상자에 표시되는 메시지가 포함된 CString 개체 또는 0으로 끝나는 문자열을 지시합니다.nType
메시지 상자의 스타일입니다. 상자에 메시지 상자 스타일을 적용합니다.nIDHelp
메시지의 도움말 컨텍스트 ID. 0은 응용 프로그램의 기본 도움말 컨텍스트가 사용됨을 나타냅니다.nIDPrompt
문자열 테이블의 문자열을 참조하는 데 사용하는 고유 ID입니다.
반환 값
메시지 상자를 표시할 메모리가 부족한 경우 0입니다. 그렇지 않으면 다음 중 한 가지 값이 반환됩니다.
IDABORT 중단 단추를 선택했습니다.
IDCANCEL 취소 단추를 선택했습니다.
IDIGNORE 무시 단추를 선택했습니다.
IDNO 선택된 단추가 없습니다.
IDOK 확인 단추를 선택했습니다.
IDRETRY 다시 시도 단추를 선택했습니다.
IDYES 예 단추를 선택했습니다.
메시지 상자에 취소 단추가 있는 경우 Esc 키를 누르거나 취소 단추를 선택하면 IDCANCEL 값이 반환됩니다. 메시지 상자에 취소 단추가 없다면, ESC 키를 눌러도 아무 소용이 없습니다.
함수 AfxFormatString1 및 AfxFormatString2 메시지 상자에 표시되는 텍스트 서식 지정에 유용하게 사용할 수 있습니다.
설명
이 오버로드된 함수의 첫 번째 폼은 메시지 상자의 lpszText가 가리키는 텍스트 문자열을 표시하고 도움말 컨텍스트를 설명하기 위해 nIDHelp를 사용합니다. 도움말 컨텍스트는 도움말 키(일반적으로 F1키)를 누를 경우 관련된 도움말 항목으로 이동하는 데 사용됩니다.
함수의 두 번째 폼에는 메시지 상자에 메시지를 표시하기 위해 ID가 nIDPrompt인 문자열 리소스가 사용됩니다. nIDHelp 값을 통해 관련 도움말 페이지를 찾습니다. nIDHelp의 기본값이 사용되는 경우(– 1) 문자열 리소스 ID인 nIDPrompt가 도움말 컨텍스트에 사용됩니다. 도움말 컨텍스트 정의에 대한 자세한 내용은 Technical Note 28을 참조하십시오.
예제
// A simple message box, with only the OK button.
AfxMessageBox(_T("Simple message box."));
// A message box that uses a string from a string table
// with yes and no buttons and the stop icon.
// NOTE: nStringID is an integer that contains a valid id of
// a string in the current resource.
AfxMessageBox(nStringID, MB_YESNO|MB_ICONSTOP);
요구 사항
헤더: afxwin.h