AfxMessageBox

Статья
02/20/2013

Отображает окно сообщения на экране.

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 или null-завершенной строку, содержащую отображаемое сообщение в окне сообщения.
nType
Стиль окна сообщения.Применение любого стили окна сообщения окна.
nIDHelp
Идентификатор контекста Справки для сообщения. 0 указывает на то, что будет использован контекст Справки приложения по умолчанию.
nIDPrompt
Уникальный идентификатор, используемый для ссылки на строку в таблице строк.

Возвращаемое значение

Нуль, если недостаточно памяти для отображения окна сообщения; в противном случае возвращается одно из следующих значений:

Кнопка IDABORT abort был установлен.
Кнопка отмена IDCANCEL был установлен.
IDIGNORE кнопка пропустить выбранные.
IDNO никакая кнопка выделяется.
Кнопка ОК IDOK выделяется.
IDRETRY кнопка повторить выделяется.
IDYES кнопку да, было выбрано.

Если окно сообщения содержит кнопку " отмена ", то будет возвращено значение IDCANCEL если нажата клавиша ESC или или кнопку отмена.Если сообщение не имеет кнопку " отмена ", то нажатие клавиши ESC не влияет.

Функции AfxFormatString1 и AfxFormatString2 могут быть полезны в тексте форматирования, отображаемый в окне сообщения.

Заметки

Первая форма этой перегруженной функции выводит текстовую строку, на которую указывает lpszText в окне сообщения и использует nIDHelp, чтобы описать контекст Справки.Контекст Справки, используемый для поскакать в связанный раздел Справки при нажатии пользователем клавиши F1 help (обычно).

Второй формой функции использует строковый ресурс с идентификатором nIDPrompt для отображения сообщения в окне сообщения.Связанная справочная страница найдена в значение nIDHelp.Если значение по умолчанию nIDHelp используется (– 1) идентификатор ресурса строки, nIDPrompt, используемое для контекста Справки.Дополнительные сведения об определении контексты Справки см. в разделе Техническая примечание 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);

Требования

Header: afxwin.h

См. также

Ссылки

CWnd::MessageBox

Основные понятия

Макросы и глобальные MFC

Поделиться через