MsgBox
Отображает простое окно сообщения с опциональным временем отображения.
MsgBox ( flag, "title", "text" [, timeout = 0 [, hwnd ]] )
Параметры
flag | Параметр указывает на тип окна сообщения и возможные комбинации отображаемых кнопок. См. примечания. |
title |
Заголовок окна сообщения. |
text |
Текст окна сообщения. |
timeout |
[необязательный] Время ожидания (в секундах), по истечении которого MsgBox будет автоматически закрыт (по умолчанию 0, что означает, что время отображения не ограничено). |
hwnd |
[необязательный] Дескриптор родительского окна. Предотвращает доступ к родительскому окну, пока существует MsgBox. |
Возвращаемое значение
Успех: | Возвращает ID нажатой кнопки. |
Ошибка: | Возвращает -1, если истекло время отображения окна сообщения. |
Нажатая кнопка | Возвращаемое значение (ID нажатой кнопки) |
---|---|
OK | 1 |
Отмена (Cancel) | 2 |
Прервать (Abort) | 3 |
Повтор (Retry) | 4 |
Пропустить (Ignore) | 5 |
Да (Yes) | 6 |
Нет (No) | 7 |
Повторить (Try again) ** | 10 |
Продолжить (Continue) ** | 11 |
Примечания
Параметр flag может быть комбинацией следующих значений:flag, Dec | Отображаемые кнопки | flag, Hex |
---|---|---|
0 | OK | 0x0 |
1 | OK и Отмена | 0x1 |
2 | Прервать, Повтор и Пропустить | 0x2 |
3 | Да, Нет и Отмена | 0x3 |
4 | Да и Нет | 0x4 |
5 | Повтор и Отмена | 0x5 |
6 ** | Отмена, Повторить, Продолжить | 0x6 |
Отображаемая иконка | ||
0 | (Нет) | 0x0 |
16 | "Стоп" | 0x10 |
32 | "Знак вопроса" | 0x20 |
48 | "Предупреждение" | 0x30 |
64 | "Информация", с 'i' в кружке | 0x40 |
Выделенная кнопка по умолчанию, вызываемая по Enter | ||
0 | Первая кнопка | 0x0 |
256 | Вторая кнопка | 0x100 |
512 | Третья кнопка | 0x200 |
Модальность | ||
0 | Приложение (Application) | 0x0 |
4096 | Системная, поверх всех окон (System modal) | 0x1000 |
8192 | Блокирует родительское окно (Task modal) | 0x2000 |
Другое | ||
0 | (ничего специального) | 0x0 |
262144 | MsgBox имеет атрибут "поверх всех окон" | 0x40000 |
524288 | Заголовок и текст выравниваются по правому краю | 0x80000 |
См. также
InputBox, ToolTip, TrayTip, SplashTextOnПример
MsgBox(4096, "Заголовок", "Это диалоговое окно закроется по таймауту через 10 секунд", 10)
; Пример выбора из 2-х действий
If MsgBox(4 + 32, 'Сообщение', 'Продолжить?') = 6 Then
MsgBox(4096, 'Результат', 'Нажата кнопка "Да"')
Else
MsgBox(16, 'Результат', 'Нажата кнопка "Нет"')
EndIf
; Пример выбора из 3-х действий
Switch MsgBox(6 + 48, 'Сообщение', 'Сделайте выбор.')
Case 2
$sText = 'Нажата кнопка "Отмена"'
Case 10
$sText = 'Нажата кнопка "Повторить"'
Case 11
$sText = 'Нажата кнопка "Продолжить"'
EndSwitch
MsgBox(64, 'Результат', $sText)