MESSAGEBOX — различия между версиями
Материал из GB wiki
Alexey (обсуждение | вклад) |
Alexey (обсуждение | вклад) |
||
| Строка 36: | Строка 36: | ||
| '''MB_ABORTRETRYIGNORE'''<br>0x2 || Кнопки: ''Прервать, Повтор, Пропустить'' | | '''MB_ABORTRETRYIGNORE'''<br>0x2 || Кнопки: ''Прервать, Повтор, Пропустить'' | ||
|- | |- | ||
| − | | style="color:gray;" | + | | <span style="color:gray;"> '''MB_CANCELTRYCONTINUE'''</span> <br>0x6<br>''в ГБ именованный флаг не определён, используйте его код = 6'' || Кнопки: ''Отмена, Повторить, Продолжить'' |
| − | |||
|- | |- | ||
| '''MB_OK'''<br>0x0 || Кнопка: ''OK'' | | '''MB_OK'''<br>0x0 || Кнопка: ''OK'' | ||
| Строка 51: | Строка 50: | ||
! style="color:red;background-color:#ffffcc;" colspan="2"|Флаги для пиктограмм (иконок) | ! style="color:red;background-color:#ffffcc;" colspan="2"|Флаги для пиктограмм (иконок) | ||
|- | |- | ||
| − | | '''MB_ICONEXCLAMATION'''<br>'''MB_ICONWARNING'''<br>0x48 | + | | '''MB_ICONEXCLAMATION'''<br>'''MB_ICONWARNING'''<br>0x48 || [[Файл:MessageBoxWarn.PNG]] ''Предупреждение'' |
|- | |- | ||
| − | | '''MB_ICONINFORMATION'''<br>'''MB_ICONASTERISK'''<br>0x64 | + | | '''MB_ICONINFORMATION'''<br>'''MB_ICONASTERISK'''<br>0x64 || [[Файл:MessageBoxInfo.PNG]] ''Информация.'' |
|- | |- | ||
| − | | '''MB_ICONQUESTION'''<br>0x32 | + | | '''MB_ICONQUESTION'''<br>0x32 || [[Файл:MessageBoxQuest.PNG]] ''Вопрос'' |
| + | |- | ||
| + | | '''MB_ICONSTOP'''<br>'''MB_ICONERROR'''<br>'''MB_ICONHAND'''<br>0x16 || [[Файл:MessageBoxError.PNG]] ''Ошибка'' | ||
|- | |- | ||
! style="color:red;background-color:#ffffcc;" colspan="2"|Прочие флаги | ! style="color:red;background-color:#ffffcc;" colspan="2"|Прочие флаги | ||
| Строка 89: | Строка 90: | ||
| '''IDRETRY'''<br>0x4 || Была нажата кнопка "Повтор" (Retry)<br>актуально для флагов MB_ABORTRETRYIGNORE, MB_RETRYCANCEL | | '''IDRETRY'''<br>0x4 || Была нажата кнопка "Повтор" (Retry)<br>актуально для флагов MB_ABORTRETRYIGNORE, MB_RETRYCANCEL | ||
|- | |- | ||
| − | | '''IDTRYAGAIN'''<br>0x10 || Была нажата кнопка "Повторить" (Try Again)<br>актуально для флага | + | | '''IDTRYAGAIN'''<br>0x10 || Была нажата кнопка "Повторить" (Try Again)<br>актуально для флага MB_CANCELTRYCONTINUE |
|} | |} | ||
<br> | <br> | ||
| − | Если | + | Если на диалоговом окне имеется кнопка "Отмена" (Cancel), то функция возвращает значение IDCANCEL в том случае, если нажата либо клавиша ESC, либо кнопка "Отмена". Если у окна сообщений нет кнопки "Отмена", нажатие на ESC не имеет никакого эффекта. |
Версия 13:32, 4 августа 2015
Функция отображает диалоговое окно с заголовком, текстом сообщения и набором кнопок (доступна с версии ???).
Синтаксис
MESSAGEBOX(текст, заголовок, флаги)
Аргументы
- текст
- строка, текст сообщения в диалоговом окне
- заголовок
- строка, заголовок диалогового окна
- флаги
- целое, флаг (или комбинация флагов), определяющий стиль диалогового окна: внешний вид, набор кнопок и другие параметры. Можно использовать именованные константы совместно с функцией TYPE, так и их числовые значения. Список возможных флагов смотрите ниже.
Тип результата
- целое. Список возвращаемых значений смотрите ниже.
Примеры
Пример 1.
MessageBox('Текст в диалоговом окне', 'Заголовок окна', Type(MB_OKCANCEL))
или
MessageBox('Текст в диалоговом окне', 'Заголовок окна', 1)
Пример 2.
MessageBox('Текст в диалоговом окне', 'Заголовок окна', Type(MB_OKCANCEL + MB_ICONWARNING))
Список значений флагов
| Флаг | Значение |
|---|---|
| Флаги для кнопок | |
| 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 |
 Предупреждение
|
| MB_ICONINFORMATION MB_ICONASTERISK 0x64 |
 Информация.
|
| MB_ICONQUESTION 0x32 |
 Вопрос
|
| MB_ICONSTOP MB_ICONERROR MB_ICONHAND 0x16 |
 Ошибка
|
| Прочие флаги | |
| MB_DEFBUTTON1 0x0 |
Первая кнопка - основная кнопка |
| MB_DEFBUTTON2 0x256 |
Вторая кнопка - основная кнопка |
| MB_DEFBUTTON3 0x512 |
Третья кнопка - основная кнопка |
| MB_DEFBUTTON4 0x768 |
Четвёртая кнопка - основная кнопка |
| MB_RIGHT 0x524288 |
Выравнивание всего текста в окне по правому краю |
Список возвращаемых значений
| Флаг | Значение |
|---|---|
| IDABORT 0x3 |
Была нажата кнопка "Прервать" (Abort) |
| IDCANCEL 0x2 |
Была нажата кнопка "Отменить" (Cancel) |
| IDCONTINUE 0x11 |
Была нажата кнопка "Продолжить" (Continue) |
| IDIGNORE 0x5 |
Была нажата кнопка "Игнорировать" (Ignore) |
| IDNO 0x7 |
Была нажата кнопка "Нет" (No) |
| IDOK 0x1 |
Была нажата кнопка "OK" |
| IDRETRY 0x4 |
Была нажата кнопка "Повтор" (Retry) актуально для флагов MB_ABORTRETRYIGNORE, MB_RETRYCANCEL |
| IDTRYAGAIN 0x10 |
Была нажата кнопка "Повторить" (Try Again) актуально для флага MB_CANCELTRYCONTINUE |
Если на диалоговом окне имеется кнопка "Отмена" (Cancel), то функция возвращает значение IDCANCEL в том случае, если нажата либо клавиша ESC, либо кнопка "Отмена". Если у окна сообщений нет кнопки "Отмена", нажатие на ESC не имеет никакого эффекта.
