Win32 API. Справочник по диалоговому окну
Страница 31. Структура MSGBOXPARAMS


Структура MSGBOXPARAMS

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

Синтаксис

typedef struct 
{
UINT cbSize;
HWND hwndOwner;
HINSTANCE hInstance;
LPCSTR lpszText;
LPCSTR lpszCaption;
DWORD dwStyle;
LPCSTR lpszIcon;
DWORD dwContextHelpId;
MSGBOXCALLBACK lpfnMsgBoxCallback;
DWORD dwLanguageId;
} MSGBOXPARAMS, *PMSGBOXPARAMS, FAR *LPMSGBOXPARAMS;

Члены структуры
cbSize
Определяет размер структуры в байтах.
hwndOwner
Идентифицирует окно владельца. Этот член структуры может быть значением ПУСТО (NULL).
hInstance
Идентифицирует экземпляр, содержащий ресурс пиктограммы, идентифицированный членом структуры lpszIcon и строковый ресурс, идентифицированный членом структуры lpszText или lpszCaption.
lpszText
Указывает на строку с символом нуля в конце, или идентификатор строкового ресурса, который содержит сообщение, которое будет отображено на экране.
lpszCaption
Указывает на строку с символом нуля в конце или идентификатор строкового ресурса, который содержит заголовок окна сообщений. Если этот член структуры имеет значение ПУСТО (NULL), по умолчанию используется заголовок, Ошибка (Error).
dwStyle
Определяет установку битов флажков, которые определяют содержание и поведение диалогового окна. Этот член структуры может быть комбинацией флажков, описанных параметром uType функции MessageBoxEx.
Кроме того, Вы можете определить флажок MB_USERICON, если хотите, чтобы окно сообщений отобразило на экране пиктограмму, заданную членом структуры lpszIcon.
lpszIcon
Идентифицирует ресурс пиктограммы. Этот параметр может быть или строкой с символом нуля в конце, или целочисленным идентификатором ресурса, переданным макрокомандой MAKEINTRESOURCE.
Чтобы загрузить одну из предопределенных пиктограмм Windows, установите член структуры hInstance в значение ПУСТО (NULL), а lpszIcon установите в одно из значений, перечисленных в функции LoadIcon.
Этот элемент игнорируется, если член структуры dwStyle не определяет флажок MB_USERICON.
dwContextHelpId
Идентифицирует контекст Справки (Help). Если происходит событие Справки (Help), это значение определено в структуре HELPINFO, которое окно сообщений передает окну владельца или функции повторного вызова.
lpfnMsgBoxCallback
Указывает на функцию повторного вызова, которая обрабатывает события Справки для окна сообщений. Функция повторного вызова имеет следующую форму:

VOID CALLBACK MsgBoxCallback(LPHELPINFO lpHelpInfo);

Если этот элемент имеет значение ПУСТО (NULL), когда происходят события Справки окно сообщений отправляет окну владельца сообщения WM_HELP.
dwLanguageId
Определяет язык, на котором отображается текст, содержащийся в предопределенных командных кнопках. Это значение должно быть в форме, возвращаемой макрокомандой MAKELANGID.
Список идентификаторов языка, поддерживаемых Win32, можно посмотреть в статье Идентификаторы Языка. Обратите внимание, что каждый привязанный к конкретной стране выпуск Windows обычно содержит ресурсы только для ограниченного набора языков. Таким образом, например, Американская версия предлагает вниманию LANG_ENGLISH, Французская версия предлагает вниманию LANG_FRENCH, Немецкая версия предлагает вниманию LANG_GERMAN и Японская версия предлагает вниманию LANG_JAPANESE. Каждая версия предлагает LANG_NEUTRAL. Это ограничивает набор значений, которые могут быть использованы параметром wLanguageId. Перед определением идентификатора языка, Вы должны перечислить местности, которые установлены в системе.

Смотри также
HELPINFO, LoadIcon, MAKEINTRESOURCE, MAKELANGID, MessageBoxEx, MessageBoxIndirect, WM_HELP

Размещение и совместимость MSGBOXPARAMS

Windows NTДа 
Win95Да
Win32sДа
Импортируемая библиотека-
Заголовочный файлWinuser.h
UnicodeWinNT
Замечания по платформеНе имеется

 
« Предыдущая статья   Следующая статья »