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

Статья
11/20/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, используется ошибки по умолчанию .

dwStyle

Тип: DWORD

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

Кроме того, можно указать флаг MB_USERICON (0x000000080L), если нужно, чтобы поле сообщения отображало значок, указанный элементом lpszIc on.

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

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

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

Замечания

Заметка

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
заголовка	winuser.h (включая Windows.h)