MessageBoxEx

Функція MessageBoxEx створює, відображає і діє вікно повідомлення. Вікно повідомлення містить повідомлення визначений у застосунку та назви, а також будь-яку комбінацію стандартні іконки і кнопки. Параметр wLanguageId визначає набір ресурсів мова використовується для попередньо кнопками. Для повного опису інших параметрів MessageBoxExперегляньте MessageBox.

int MessageBoxEx ( HWND  hWnd, / / ручка вікна власникаLPCTSTRlpText, / / адреса тексту в полі повідомленняLPCTSTRlpCaption, / / адреса назви вікна повідомленняUINTuType, / / стиль вікна повідомленняСловоwLanguageId / / ідентифікатор мови);

Параметри

hWnd
Ідентифікує власника вікно повідомлення поля, щоб створити. Якщо цей параметр має значення NULL, вікно повідомлення має жодне вікно не власник.
lpCaption
Вказівник на нульовим закінченням, що містить повідомлення, для відображення.
lpszTitle
Вказівник на рядок для назви діалогового вікна. Якщо цей параметр має значення NULL, назву за промовчанням помилки використовується.
uType
Визначає набір прапорів біт, що визначають вміст і поведінки в діалоговому вікні. Цей параметр може бути поєднання прапори з таких груп прапори.

Задайте один з наступних прапори вказати кнопки, що містяться у вікні повідомлення:
Прапор Значення
MB_ABORTRETRYIGNORE Вікно повідомлення містить три кнопки: перервати, повторіть спробу і ігнорувати.
MB_OK Вікно повідомлення містить одна кнопка: ОК. Це за замовчуванням.
MB_OKCANCEL Вікно повідомлення містить дві кнопки: ОК і скасувати.
MB_RETRYCANCEL Вікно повідомлення містить дві кнопки: повторити та скасувати.
MB_YESNO Вікно повідомлення містить дві кнопки: так і ні.
MB_YESNOCANCEL Вікно повідомлення містить три кнопки: так, ні і скасувати.

Задайте один з наступних прапорів для відображення піктограми у вікні повідомлення:
Прапор Значення
MB_ICONEXCLAMATION,
MB_ICONWARNING
 Знак оклику значок відображається у вікні повідомлення.
MB_ICONINFORMATION, MB_ICONASTERISK
 З'являється значок, що складається з на малу літеру я в коло у вікні повідомлення.
MB_ICONQUESTION Знак питання значок відображається у вікні повідомлення.
MB_ICONSTOP,
MB_ICONERROR,
MB_ICONHAND
 В полі повідомлення з'являється значок знак зупинки.

Задайте один з наступних прапори вказати кнопку за промовчанням:
Прапор Значення
MB_DEFBUTTON1 Перша кнопка є кнопкою за промовчанням.

MB_DEFBUTTON1 використовується за замовчуванням, якщо не вказано MB_DEFBUTTON2, MB_DEFBUTTON3 або MB_DEFBUTTON4.
MB_DEFBUTTON2 Друга кнопка є кнопкою за промовчанням.
MB_DEFBUTTON3 Третя кнопка є кнопкою за промовчанням.
MB_DEFBUTTON4 Четверта кнопка є кнопкою за промовчанням.

Виберіть одне з таких прапорів для позначення модальність діалогового вікна:
Прапор Значення
MB_APPLMODAL Користувач має реагувати на полі повідомлення перед продовженням роботи у вікні визначені параметр hWnd . Однак, користувач може перейти до windows інші теми і працювати в цих windows.

Залежно від того, ієрархія windows у додатку користувач може бути здатна перейти до інших вікон у гілці. Усі дочірні вікна батьківського вікна повідомлення автоматично вимикаються, але не є блокування спливаючих вікон.

MB_APPLMODAL використовується за замовчуванням, якщо вказано ні MB_SYSTEMMODAL, ні MB_TASKMODAL.
MB_SYSTEMMODAL Само, як MB_APPLMODAL, хіба що в вікні повідомлення має стиль WS_EX_TOPMOST. Використання системи модальних повідомлення ящики сповіщати користувача про серйозні, потенційно небезпечного помилки, що вимагають негайної уваги (наприклад, працює з пам'яті). Цей прапор має ніякого ефекту на користувача здатність взаємодіяти з windows, крім тих, що пов'язані з hWnd.
MB_TASKMODAL Само, як MB_APPLMODAL, хіба що верхнього рівня windows, що належать до поточний потік вимкнуто, якщо параметр hWnd є NULL. Використовувати цей прапор під час виклику застосунки чи бібліотеки не має дескриптор вікна, доступні, але все ще потребує, щоб заборонити введення, щоб інші вікна в потоці IP-телефонії без призупинення інші теми.

Крім того, ви можете вказати наступні варіанти стану:

MB_DEFAULT_DESKTOP_ONLY
Робочий стіл, в даний час отримання вводу має бути робочий стіл за замовчуванням; в іншому випадку функція не може. За промовчанням робочий стіл є одним програма працює на після того, як користувач має ввійти.
MB_HELP
Додає кнопку довідки у вікні повідомлення. Вибір Довідка "або натисніть клавішу F1 створює події довідки.
MB_RIGHT
Текст є вирівнюванням праворуч.
MB_RTLREADING
Відображає повідомлення та підпис текст за допомогою порядок читання справа наліво на іврит та Арабська систем.
MB_SETFOREGROUND
Вікно повідомлення стає переднього вікна. Внутрішньо, система закликає SetForegroundWindow функції вікно повідомлення.
MB_TOPMOST
Вікно повідомлення створюється стиль вікна WS_EX_TOPMOST.
MB_SERVICE_NOTIFICATION
Windows NT: Абонент – це послуга, що повідомляє користувача про подію. Функція відображає повідомлення на поточний active desktop, навіть якщо користувач не ввійшов до системи.

Якщо цей прапор, hWnd параметр має бути NULL. Це так у вікні повідомлення може відображатися на робочому столі, інші, ніж робочого стола відповідні до hWnd.

Для Windows NT версії 4.0 змінив значення MB_SERVICE_NOTIFICATION. Див WINUSER.H для старих і нових значень. Windows NT 4.0 забезпечує сумісність для вже існуючих послуг шляхом зіставлення старе значення на нові значення виконання MessageBox і MessageBoxEx. Це відображення здійснюється тільки для виконуваних файлів, які мають номер версії, як набір на компонувальник, менше, ніж 4.0.

Побудувати послуга, яка використовує MB_SERVICE_NOTIFICATION і може працювати на Windows NT 3. x і Windows NT 4.0, у вас є два вибори.
  1. Під час компонування вкажіть менше, ніж номер версії 4.0; або
nbsp;   2. Під час компонування вкажіть версії 4.0. Під час виконання використовувати функцію GetVersionEx , щоб перевірити версію системи. Потім, коли працює на Windows &NT 3. x, за допомогою MB_SERVICE_NOTIFICATION_NT3X; і на Windows NT 4.0, використання MB_SERVICE_NOTIFICATION.

MB_SERVICE_NOTIFICATION_NT3X
Windows NT: Це значення відповідає значення, визначені для MB_SERVICE_NOTIFICATION для Windows NT версії 3.51.
wLanguageId
Визначає мову для відображення тексту в попередньо кнопками. Це значення має бути в формі, повернутих на MAKELANGID макросів.

Переглянути список ідентифікатори мови, які підтримуються Win32, Мова ідентифікатори. Зауважте, що кожна локалізовані версії Windows і Windows NT, зазвичай, містить ресурси лише для обмеженого набору мов. Таким чином, наприклад, Версія для США пропонує LANG_ENGLISH, французька версія пропонує LANG_FRENCH, німецька версія пропонує LANG_GERMAN та японська версія пропонує LANG_JAPANESE. Кожна версія пропонує LANG_NEUTRAL. Це обмежує набір значень, які можуть бути використані з wLanguageId параметр. Перед вказавши ідентифікатор мови, має перерахувати локалі, які інстальовано в системі.

Повернення значень

Якщо функція завершено успішно, значення — це значення ненульовий елемент меню, повернутих у діалоговому вікні.

Значення Значення
IDABORT Припинення кнопка була обрана.
IDCANCEL Було вибрано кнопку "Скасувати".
IDIGNORE Ігнорувати було вибрано кнопку.
IDNO Було вибрано не кнопки.
IDOK Було вибрано кнопку "OK".
IDRETRY Було вибрано кнопку "Повторити".
IDYES Так було вибрано кнопку.

Якщо вікно повідомлення кнопку Скасувати, функція повертає значення IDCANCEL, коли натиснуто клавішу esc або кнопку "Скасувати". Якщо вікно повідомлення немає кнопки "Скасувати", натисніть клавішу esc не діє.

Якщо функцію не вдається, значення дорівнює нулю. Щоб отримати докладні відомості про помилку, зателефонуйте GetLastError.

Зауваження

Під час створення вікна повідомлення системи модальних вказати що системі не вистачає пам'яті, струни, прийнятий як lpText і lpCaption параметри не слід приймати від файлу ресурсів, тому що може не спроба завантажити ресурс.

Коли програма викликає функцію MessageBoxEx і визначає MB_ICONHAND і MB_SYSTEMMODAL прапорів для параметра uType , Win32 API відображає отриманий вікно повідомлення, незалежно від того, доступної пам'яті. Коли ви визначаєте ці прапори, система обмежує довжину вікно повідомлення тексту в один рядок.

Вікно повідомлення під час діалогове вікно присутня, використовувати маркер у діалоговому вікні як параметр hWnd . HWnd параметр не слід визначити дочірнього вікна, наприклад, у діалоговому вікні.

Windows 95:Система може підтримувати максимум 16,364 вікно ручки.

QuickInfo

nbsp; Windows &NT: вимагає 3.1 або пізнішої версії.
Windows:Вимагає Windows 95 або пізнішої версії.
Windows CE:Не підтримується.
Заголовка:Оголошена в winuser.h.
Імпортувати бібліотеки:Використання user32.lib.
Юнікод:Реалізований у вигляді Юнікод і ANSI версії Windows і Windows NT.

Дивіться також

Діалогове вікно огляд коробки, діалоговому вікні функції, MAKELANGID, MessageBeep,MessageBox , MessageBoxIndirect, SetForegroundWindow

Index