MESSAGEBOX

Материал из GB wiki
Перейти к: навигация, поиск

Функция отображает диалоговое окно с заголовком, текстом сообщения и набором кнопок (доступна с версии ???).

Синтаксис

MESSAGEBOX(текст, заголовок, флаги)

Аргументы

текст
строка, текст сообщения в диалоговом окне
заголовок
строка, заголовок диалогового окна
флаги
целое, флаг (или комбинация флагов), определяющий стиль диалогового окна: внешний вид, набор кнопок и другие параметры. Можно использовать как именованные константы совместно с функцией TYPE, так и их числовые значения. Список возможных флагов смотрите ниже.

Тип результата

целое. Список возвращаемых значений смотрите ниже.

Примеры

Пример 1.
MessageBox(`Текст в диалоговом окне`, `Заголовок окна`, Type(MB_OKCANCEL))
или
MessageBox(`Текст в диалоговом окне`, `Заголовок окна`, 1)
MessageBox1.PNG


Пример 2.
MessageBox(`Текст в диалоговом окне`, `Заголовок окна`, Type(MB_OKCANCEL + MB_ICONWARNING))
MessageBox2.PNG


Список значений флагов

Флаг Значение
Флаги для кнопок
MB_ABORTRETRYIGNORE
0x2
Кнопки: Прервать, Повтор, Пропустить
MB_CANCELTRYCONTINUE
0x6
в ГБ именованный флаг не определён, используйте его код = 6
Кнопки: Отмена, Повторить, Продолжить
MB_OK
0x0
Кнопка: OK
MB_OKCANCEL
0x1
Кнопки: OK, Отмена
MB_RETRYCANCEL
0x5
Кнопки: Повтор, Отмена
MB_YESNO
0x4
Кнопки: Да, Нет
MB_YESNOCANCEL
0x3
Кнопки: Да, Нет, Отмена
Флаги для пиктограмм (иконок)
MB_ICONEXCLAMATION
MB_ICONWARNING
0x48
MessageBoxWarn.PNG Предупреждение
MB_ICONINFORMATION
MB_ICONASTERISK
0x64
MessageBoxInfo.PNG Информация
MB_ICONQUESTION
0x32
MessageBoxQuest.PNG Вопрос
MB_ICONSTOP
MB_ICONERROR
MB_ICONHAND
0x16
MessageBoxError.PNG Ошибка
Прочие флаги
MB_DEFBUTTON1
0x0
Первая кнопка - основная кнопка
MB_DEFBUTTON2
0x256
Вторая кнопка - основная кнопка
MB_DEFBUTTON3
0x512
Третья кнопка - основная кнопка
MB_DEFBUTTON4
0x768
Четвёртая кнопка - основная кнопка
MB_RIGHT
0x524288
Выравнивание всего текста в окне по правому краю


Список возвращаемых значений

Флаг Значение
IDOK
0x1
Была нажата кнопка "OK"
IDCANCEL
0x2
Была нажата кнопка "Отменить" (Cancel)
IDABORT
0x3
Была нажата кнопка "Прервать" (Abort)
IDRETRY
0x4
Была нажата кнопка "Повтор" (Retry)
актуально для флагов MB_ABORTRETRYIGNORE, MB_RETRYCANCEL
IDIGNORE
0x5
Была нажата кнопка "Игнорировать" (Ignore)
IDYES
0x6
Была нажата кнопка "Да" (Yes)
IDNO
0x7
Была нажата кнопка "Нет" (No)
IDTRYAGAIN
0x10
Была нажата кнопка "Повторить" (Try Again)
актуально для флага MB_CANCELTRYCONTINUE
IDCONTINUE
0x11
Была нажата кнопка "Продолжить" (Continue)


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