Функция 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,
Размещение и совместимость 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 |
Нет |
Замечания по платформе |
Не имеется |