Функция MessageBoxIndirect

Функция MessageBoxIndirect создает, показывает на экране и использует окно сообщения. Окно сообщения содержит определяемый программой текст сообщения и заголовок, любой значок и любую комбинацию предопределенных командных кнопок.

Синтаксис

int MessageBoxIndirect( 
    const LPMSGBOXPARAMS lpMsgBoxParams
);

Параметры

lpMsgBoxParams

[in] Указатель на структуру MSGBOXPARAMS, которая содержит информацию, используемую, чтобы показать на экране окно сообщения.

Возвращаемое значение

Если функция завершается успешно, возвращаемое значение - одно из ниже перечисленных значений пункта меню.

Если окно сообщения имеет кнопку Отменить (Cancel), то функция возвращает значение IDCANCEL, если или обрабатывается клавиша ESC, или выбрана кнопка Отменить (Cancel). Если окно сообщения не имеет кнопки Отменить (Cancel), нажатия ESC не имеет никакого действия.

Если недостаточно памяти, чтобы создать окно сообщения, возвращаемое значение равняется нулю.

Значение Предназначение
IDABORT Была выбрана кнопка Прекратить (Abort).
IDCANCEL Была выбрана кнопка Отменить (Cancel).
IDCONTINUE Была выбрана кнопка Продолжить (Continue).
IDIGNORE Была выбрана кнопка Пропустить (Ignore).
IDNO Была выбрана кнопка Нет (No).
IDOK Была выбрана кнопка OK.
IDRETRY Была выбрана кнопка Поторить (Retry).
IDTRYAGAIN Была выбрана кнопка Попытаться снова (Try Again).
IDYES Была выбрана кнопка Да (Yes).

Замечания

Когда Вы используете работающее в системном (недоступном) режиме окно сообщения, которое обращает внимание на то, что в системе мало памяти, строки, на которые указывают члены lpszText и lpszCaption  структуры MSGBOXPARAMS не должны браться из файла ресурса, потому что попытка загрузить ресурс может завершиться ошибкой.

Если Вы создаете окно сообщения, в то время, когда диалоговое окно присутствует, используйте дескриптор блока диалога как  параметр hWnd.  Параметр hWnd не должен идентифицировать дочернее окно, такое как орган управления в блоке диалога.

Windows 95/98/Me: Система может поддержать максимум 16 364 дескриптора окна.

Windows 95/98/Me: MessageBoxIndirectW поддерживается программой Microsoft Layer for Unicode. Чтобы использовать эту функцию, Вы должны добавить некоторые файлы к вашему приложению, как изложено в описании Microsoft Layer for Unicode для системы Windows 95/98/Me.

Смотри также 

Обзор Диалоговые окнаФункции, используемые диалоговыми окнами,  MessageBox, MessageBoxEx, MSGBOXPARAMS 

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

Windows. NET Server

Да

Windows XP

Да

Windows 2000

Да

Windows NT

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

Windows Me

Да

Windows 98

Да

Windows 95

Да

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

User32.lib

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

 

- объявлено в

Winuser.h

- включено в

Windows.h

Unicode

Нет

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

Не имеется

 

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

Hosted by uCoz