Структура MSGBOXPARAMS

Структура 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, LoadIcon, MAKEINTRESOURCE, MAKELANGID, MessageBoxEx, MessageBoxIndirect, WM_HELP

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

Windows. NET Server

Да

Windows XP

Да

Windows 2000

Да

Windows NT

Да версии 3.1 и выше

Windows Me

Да

Windows 98

Да

Windows 95

Да

Используемая библиотека

-

Заголовочный файл

 

- объявлено в

Winuser.h

- включено в

Windows.h

Unicode

Нет

Замечания по платформе

Не имеется

 

Назад в оглавление
На главную страницу
На оглавление справки

Hosted by uCoz