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 или строку, оканчивающуюся на null и содержащую сообщение для отображения в окне сообщения.nType
Стиль окна сообщения. Примените к окну любой из стилей окон сообщений.nIDHelp
Идентификатор контекста справки для сообщения; 0 указывает на то, что контекст справки по умолчанию приложения будет использоваться.nIDPrompt
Уникальный идентификатор, используемый для ссылок на строку в таблице строк.
Возвращаемое значение
Ноль, если недостаточно памяти для отображения окна сообщения; в противном случае возвращается одно из следующих значений.
IDABORT Выбрана кнопка прерывания.
IDCANCEL Выбрана кнопка отмены.
IDIGNORE Выбрана кнопка игнорирования.
IDNO Выбрана кнопка "Нет".
IDOK Выбрана кнопка "ОК".
IDRETRY Выбрана кнопка "Повторить".
IDYES Выбрана кнопка "Да".
Если сообщение имеет кнопку "Отмена", то будет возвращено значение IDCANCEL, если нажата клавиша ESC или кнопка "Отмена". Если в поле сообщения отсутствует кнопка "Отмена", нажатие клавиши ESC не даст никакого результата.
Функции AfxFormatString1 и AfxFormatString2 могут быть полезны в тексте форматирования, отображаемом в окне сообщения.
Заметки
Первая форма данной перегруженной функции отображается строка указанную значение lpszText в окне сообщения и использует nIDHelp для описания контекст справки. Контекст справки для предоставления поскакать с соответствующим разделом справки, когда пользователь нажимает ключ (обычно справки F1).
Вторая форма функции использует строковый ресурс с идентификатором 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);
Требования
Заголовок: afxwin.h