Метод IConsole::MessageBox (mmc.h)

Статья
08/24/2023

Отображает окно сообщения.

Синтаксис

HRESULT MessageBox(
  [in]  LPCWSTR lpszText,
  [in]  LPCWSTR lpszTitle,
  [in]  UINT    fuStyle,
  [out] int     *piRetval
);

Параметры

[in] lpszText

Указатель на строку, завершающуюся значением NULL, которая содержит отображаемое сообщение.

[in] lpszTitle

Указатель на строку, завершаемую null, которая используется для заголовка окна сообщения. Если этот параметр имеет значение NULL, используется название по умолчанию "Error".

[in] fuStyle

Значение типа , указывающее набор битовых флагов, определяющих содержимое и поведение окна сообщения. Этот параметр может быть сочетанием флагов из следующих групп флагов, взятых из документации по Windows API MessageBox.

Укажите один из следующих флагов, чтобы указать, какие кнопки отображаются в окне сообщения.

MB_ABORTRETRYIGNORE

Окно сообщения содержит три кнопки: "Прервать", "Повторить" и "Пропустить".

MB_OK

Окно сообщения содержит одну кнопку: ОК. Это значение по умолчанию.

MB_OKCANCEL

Окно сообщения содержит две кнопки: ОК и Отмена.

MB_RETRYCANCEL

Окно сообщения содержит две кнопки: Повторить и Отмена.

MB_YESNO

Окно сообщения содержит две кнопки: Да и Нет.

MB_YESNOCANCEL

Окно сообщения содержит три кнопки: Да, Нет и Отмена.

Укажите один из следующих флагов, чтобы указать, какой значок отображается в окне сообщения:

MB_ICONEXCLAMATION, MB_ICONWARNING

В окне сообщения появится значок восклицательного знака.

MB_ICONINFORMATION, MB_ICONASTERISK

В окне сообщения появится значок , состоящий из "I" в круге.

MB_ICONQUESTION

В окне сообщения появится значок вопросительного знака.

MB_ICONSTOP,

MB_ICONERROR, MB_ICONHAND

В окне сообщения появится значок знака остановки.

Укажите один из следующих флагов, чтобы указать кнопку по умолчанию:

MB_DEFBUTTON1

Первая кнопка является кнопкой по умолчанию, если в качестве значения по умолчанию не указан один из других флагов в этой группе.

MB_DEFBUTTON2

Вторая кнопка является кнопкой по умолчанию.

MB_DEFBUTTON3

Третья кнопка является кнопкой по умолчанию.

MB_DEFBUTTON4

Четвертая кнопка является кнопкой по умолчанию.

Укажите один из следующих флагов, чтобы указать модальность диалогового окна:

MB_APPLMODAL

Пользователь должен ответить на окно сообщения, прежде чем продолжить работу в текущем окне. Однако пользователь может переходить в окна других приложений и работать в этих окнах. Значение по умолчанию — MB_APPLMODAL , если не указаны ни MB_SYSTEMMODAL , ни MB_TASKMODAL .

MB_SYSTEMMODAL

Все приложения приостанавливаются до тех пор, пока пользователь не ответит на окно сообщения. Системно-модальные окна сообщений используются для уведомления пользователя о серьезных, потенциально опасных ошибках, которые требуют немедленного внимания и должны использоваться с большими затратами.

MB_TASKMODAL

Аналогично MB_APPLMODAL, но не полезен в приложении Microsoft Foundation Classes (MFC). Этот флаг зарезервирован для вызывающего приложения или библиотеки, у которых нет доступного дескриптора окна.

Кроме того, можно указать следующие флаги:

MB_DEFAULT_DESKTOP_ONLY

Рабочий стол, получающий входные данные, должен быть рабочим столом по умолчанию; в противном случае функция завершается ошибкой. Рабочий стол по умолчанию — это рабочий стол, на котором приложение запускается после входа пользователя в систему.

MB_HELP

Добавляет в окно сообщения кнопку Справка . При нажатии кнопки Справка или нажатии клавиши F1 создается событие справки.

MB_RIGHT

Текст оправдан по правому краю.

MB_RTLREADING

Отображает сообщение и подпись текст, используя порядок чтения справа налево для иврита и арабского языка.

MB_SETFOREGROUND

Окно сообщения становится окном переднего плана. На внутреннем компьютере операционная система вызывает функцию SetForegroundWindow для окна сообщения.

MB_TOPMOST

Окно сообщения создается в стиле окна WS_EX_TOPMOST .

MB_SERVICE_NOTIFICATION

Вызывающий объект — это служба, которая уведомляет пользователя о событии. Функция отображает окно сообщения на текущем активном рабочем столе, даже если пользователь не вошел в систему.

Дополнительные сведения об использовании этого флага см. в разделе Функция MessageBox .

MB_SERVICE_NOTIFICATION_NT3x

Это значение соответствует значению, определенному для MB_SERVICE_NOTIFICATION для более ранних версий Windows.

[out] piRetval

Указатель на возвращаемое значение.

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

Этот метод может возвращать одно из этих значений.

MessageBox следует использовать только в том случае, если ошибка требует внимания пользователя и если панель результатов содержит полезные сведения, несмотря на ошибку.

В большинстве случаев элемент управления OCX сообщений MMC является более подходящим способом отображения сообщений об ошибках. Дополнительные сведения см. в разделе Использование элемента управления OCX сообщений MMC.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista
Минимальная версия сервера	Windows Server 2008
Целевая платформа	Windows
Header	mmc.h
DLL	Mmcndmgr.dll

См. также раздел

IConsole

Поделиться через