Структура MSGBOXPARAMS содержит информацию, используемую, чтобы показать на экране окно сообщения. Функция MessageBoxIndirect использует эту структуру.
Синтаксис
typedef struct { UINT cbSize; HWND hwndOwner; HINSTANCE hInstance; LPCTSTR lpszText; LPCTSTR lpszCaption; DWORD dwStyle; LPCTSTR lpszIcon; DWORD_PTR dwContextHelpId; MSGBOXCALLBACK lpfnMsgBoxCallback; DWORD dwLanguageId; } MSGBOXPARAMS, *PMSGBOXPARAMS; |
Члены структуры
cbSize
Устанавливает размер структуры, в байтах.hwndOwner
Дескриптор окна владельца. Этот член структуры может быть ПУСТО (NULL).hInstance
Дескриптор модуля, который содержит ресурс значка, идентифицированный членом структуры lpszIcon, и строковый ресурс, идентифицированный членом структуры lpszText или lpszCaption.lpszText
Указатель на символьную строку с нулем в конце, или идентификатор строкового ресурса, который содержит сообщение, которое появляется на экране.
lpszCaption
Указатель на символьную строку с нулем в конце, или идентификатор строкового ресурса, который содержит заголовок окна сообщения. Если этот член структуры - ПУСТО (NULL), используется заданный по умолчанию заголовок, Error (Ошибка).
dwStyle
Устанавливает содержание и характер работы диалогового окна. Этот член структуры может быть комбинацией флажков, описанных для параметра uType функции MessageBoxEx.
Кроме того, Вы можете установить флажок MB_USERICON, если хотите, чтобы окно сообщения показало на экране значок, определенный членом структуры lpszIcon.
lpszIcon
Идентифицирует ресурс значка. Этим параметром может быть или символьная строка с нулем в конце, или целочисленный идентификатор ресурса переданный в макрокоманду MAKEINTRESOURCE.
Чтобы загрузить один из стандартных определяемых системой значков, установите член структуры hInstance в ПУСТО (NULL), и установите lpszIcon в одно из значений, перечисляемых в функции LoadIcon.
Этот член структуры игнорируется, если член структуры dwStyle не устанавливает флажок MB_USERICON.
dwContextHelpId
Идентифицирует контекст справки. Если происходит событие справки, это значение определяется в структуре HELPINFO, которое окно сообщения отправляет в окно владельца или функцию повторного вызова.
lpfnMsgBoxCallback
Указатель на функцию повторного вызова, которая обрабатывает события справки для окна сообщения. Функция повторного вызова имеет нижеследующую форму:
VOID CALLBACK MsgBoxCallback(LPHELPINFO lpHelpInfo); |
Если этот член структуры - ПУСТО (NULL), окно сообщения отправляет сообщения WM_HELP окну владельцу, когда происходят события справки.
dwLanguageId
Устанавливает язык, на котором показывается на экране текст, содержащийся в предопределенных командных кнопках. Это значение должно находиться в форме, возвращенной макросом MAKELANGID.
Список поддерживаемых идентификаторов языка, см. в статье Идентификаторы языка.
Обратите внимание! на то, что каждый национальный выпуск Microsoft ® Windows ® 95/98/Me и Microsoft ® Windows NT обычно содержит ресурсы только для ограниченного набора языков. В соответствии с этим, например, американская версия предлагает LANG_ENGLISH, французская версия предлагает LANG_FRENCH, немецкая версия предлагает LANG_GERMAN, а японская версия предлагает LANG_JAPANESE. Каждая версия предлагает LANG_NEUTRAL. |
Это ограничивает набор значений, которые могут использоваться параметром dwLanguageId. Перед определением идентификатора языка, вам следует перечислить страны, которые установлены в системе.
Смотри также
Обзор Диалоговые окна, Структуры,
используемые диалоговыми окнами, HELPINFO,
Размещение и совместимость MSGBOXPARAMS |
|
Windows. NET Server |
Да |
Windows XP |
Да |
Windows 2000 |
Да |
Windows NT |
Да версии 3.1 и выше |
Windows Me |
Да |
Windows 98 |
Да |
Windows 95 |
Да |
Используемая библиотека |
- |
Заголовочный файл |
|
- объявлено в |
Winuser.h |
- включено в |
Windows.h |
Unicode |
Нет |
Замечания по платформе |
Не имеется |