Функция MessageBoxIndirectA (winuser.h)

Статья
08/27/2023

Создает, отображает и управляет окном сообщения. Окно сообщения содержит текст и заголовок сообщения, определяемые приложением, любой значок и любое сочетание предопределенных кнопок нажатия.

Синтаксис

int MessageBoxIndirectA(
  [in] const MSGBOXPARAMSA *lpmbp
);

Параметры

[in] lpmbp

Тип: const LPMSGBOXPARAMS

Указатель на структуру MSGBOXPARAMS , содержащую сведения, используемые для отображения окна сообщения.

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

Тип: int

Если функция выполнена успешно, возвращается одно из следующих значений пункта меню.

Если в окне сообщения есть кнопка Отмена , функция возвращает значение IDCANCEL при нажатии клавиши ESC или нажатии кнопки Отмена . Если в окне сообщения нет кнопки Отмена , нажатие клавиши ESC не оказывает никакого влияния.

Если для создания окна сообщения недостаточно памяти, возвращаемое значение равно нулю.

Возвращаемый код или значение	Описание
IDABORT 3	Была выбрана кнопка "Прервать ".
IDCANCEL 2	Была выбрана кнопка Отмена .
IDCONTINUE 11	Была выбрана кнопка Продолжить .
IDIGNORE 5	Была выбрана кнопка Пропустить .
IDNO 7	Выбрана кнопка Нет .
IDOK 1	Была выбрана кнопка ОК .
IDRETRY 4	Была выбрана кнопка Повторить .
IDTRYAGAIN 10	Была выбрана кнопка Повторить попытку.
IDYES 6	Выбрана кнопка Да .

При использовании системно-модального окна сообщения, указывающего на нехватку памяти в системе, строки, на которые указывают члены lpszText и lpszCaption структуры MSGBOXPARAMS , не следует брать из файла ресурсов, так как попытка загрузки ресурса может завершиться ошибкой.

Если вы создаете окно сообщения при наличии диалогового окна, используйте дескриптор для диалогового окна в качестве параметра hWnd . Параметр hWnd не должен идентифицировать дочернее окно, например элемент управления в диалоговом окне.

Примечание

Заголовок winuser.h определяет MessageBoxIndirect в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования


Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	winuser.h (включая Windows.h)
Библиотека	User32.lib
DLL	User32.dll
Набор API	ext-ms-win-ntuser-dialogbox-l1-1-0 (появилось в Windows 8)