Структура MSGBOXPARAMSA (winuser.h)

Статья
03/04/2024

Содержит сведения, используемые для отображения окна сообщения. Эта структура используется в функции MessageBoxIndirect .

Синтаксис

typedef struct tagMSGBOXPARAMSA {
  UINT           cbSize;
  HWND           hwndOwner;
  HINSTANCE      hInstance;
  LPCSTR         lpszText;
  LPCSTR         lpszCaption;
  DWORD          dwStyle;
  LPCSTR         lpszIcon;
  DWORD_PTR      dwContextHelpId;
  MSGBOXCALLBACK lpfnMsgBoxCallback;
  DWORD          dwLanguageId;
} MSGBOXPARAMSA, *PMSGBOXPARAMSA, *LPMSGBOXPARAMSA;

Члены

cbSize

Тип: UINT

Размер структуры в байтах.

hwndOwner

Тип: HWND

Дескриптор окна-владельца. Этот элемент может иметь значение NULL.

hInstance

Тип: HINSTANCE

Дескриптор модуля, который содержит ресурс значка, определяемый элементом lpszIcon , и строковый ресурс, определяемый элементом lpszText или lpszCaption .

lpszText

Тип: LPCTSTR

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

lpszCaption

Тип: LPCTSTR

Строка, завершающаяся значением NULL, или идентификатор строкового ресурса, который содержит заголовок окна сообщения. Если этот элемент имеет значение NULL, используется название по умолчанию Error .

dwStyle

Тип: DWORD

Содержимое и поведение диалогового окна. Этот элемент может быть сочетанием флагов, описанных для параметра uType функции MessageBoxEx .

Кроме того, можно указать флаг MB_USERICON (0x00000080L), если нужно, чтобы в окне сообщения отображались значки, указанные элементом lpszIcon .

lpszIcon

Тип: LPCTSTR

Определяет ресурс значка. Этот параметр может быть строкой, завершающейся значением NULL, или целочисленным идентификатором ресурса, передаваемым макросу MAKEINTRESOURCE .

Чтобы загрузить один из стандартных системных значков, присвойте члену hInstanceзначение NULL , а для lpszIcon — одно из значений, перечисленных с помощью функции LoadIcon .

Этот элемент игнорируется, если в элементе dwStyle не указан флаг MB_USERICON .

dwContextHelpId

Тип: DWORD_PTR

Определяет контекст справки. При возникновении события справки это значение указывается в структуре HELPINFO , которую окно сообщения отправляет в окно владельца или функцию обратного вызова.

lpfnMsgBoxCallback

Тип: MSGBOXCALLBACK

Указатель на функцию обратного вызова, которая обрабатывает события справки для окна сообщения. Функция обратного вызова имеет следующий вид:

VOID CALLBACK MsgBoxCallback(LPHELPINFO lpHelpInfo);

Если этот элемент имеет значение NULL, окно сообщения отправляет WM_HELP сообщения в окно владельца при возникновении событий справки.

dwLanguageId

Тип: DWORD

Язык, на котором отображается текст, содержащийся в предопределенных кнопках нажатия. Это значение должно быть в форме, возвращаемой макросом MAKELANGID .

Список поддерживаемых идентификаторов языка см. в разделе Идентификаторы языков. Обратите внимание, что каждый локализованный выпуск Windows обычно содержит ресурсы только для ограниченного набора языков. Так, например, версия для США предлагает LANG_ENGLISH, французская версия — LANG_FRENCH, немецкая — LANG_GERMAN, а японская — LANG_JAPANESE. Каждая версия предлагает LANG_NEUTRAL. Это ограничивает набор значений, которые можно использовать с параметром dwLanguageId . Перед указанием идентификатора языка необходимо перечислить языковые стандарты, установленные в системе.

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

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Верхняя часть	winuser.h (включая Windows.h)