MESSAGEBOX — различия между версиями

Материал из GB wiki
Перейти к: навигация, поиск
Строка 13: Строка 13:
 
}}<br/>{{Аргумент
 
}}<br/>{{Аргумент
 
  |Название=флаги
 
  |Название=флаги
−
  |Пояснение=целое, флаг (или комбинация флагов), определяющий стиль диалогового окна: внешний вид, набор кнопок и другие параметры. Можно использовать именованные константы совместно с функцией TYPE, так и их числовые значения. [[#Флаги для кнопок|Список возможных флагов]] смотрите ниже.
+
  |Пояснение=целое, флаг (или комбинация флагов), определяющий стиль диалогового окна: внешний вид, набор кнопок и другие параметры. Можно использовать именованные константы совместно с функцией TYPE, так и их числовые значения. [[#Список значений флагов|Список возможных флагов]] смотрите ниже.
 
}}
 
}}
−
|Результат=целое. [[#Флаги для кнопок|Список возможных флагов]] смотрите ниже.
+
|Результат=целое. Список [[#Список возвращаемых значений|возвращаемых значений]] смотрите ниже.
 
|Пример=Пример 1.
 
|Пример=Пример 1.
 
<br/>MessageBox('Текст в диалоговом окне', 'Заголовок окна', Type(MB_OKCANCEL))
 
<br/>MessageBox('Текст в диалоговом окне', 'Заголовок окна', Type(MB_OKCANCEL))
Строка 29: Строка 29:
 
<br/>
 
<br/>
 
====Список значений флагов====
 
====Список значений флагов====
−
{| border="1" cellpadding="5" style="background-color:#ffffdd;"
+
{| border="1" cellpadding="3" style="background-color:#ffffdd;"
 
!  Флаг                                !! Значение
 
!  Флаг                                !! Значение
 
|-
 
|-
Строка 36: Строка 36:
 
|  '''MB_ABORTRETRYIGNORE'''<br>0x2    ||  Кнопки: ''Прервать, Повтор, Пропустить''
 
|  '''MB_ABORTRETRYIGNORE'''<br>0x2    ||  Кнопки: ''Прервать, Повтор, Пропустить''
 
|-
 
|-
−
|  именованный флаг отсутствует<br>0x6  ||  Кнопки: ''Отмена, Повтор, Продолжить''
+
|  MB_CANCELTRYCONTINUE<br>0x6<br>''в ГБ именованный флаг не определён, используйте его код = 6'' ||  Кнопки: ''Отмена, Повторить, Продолжить''
 
|-
 
|-
 
|  '''MB_OK'''<br>0x0                  ||  Кнопка: ''OK''
 
|  '''MB_OK'''<br>0x0                  ||  Кнопка: ''OK''
Строка 58: Строка 58:
 
! style="color:red;background-color:#ffffcc;" colspan="2"|Прочие флаги
 
! style="color:red;background-color:#ffffcc;" colspan="2"|Прочие флаги
 
|-
 
|-
−
|  '''MB_DEFBUTTON1'''<br>0x0   ||  Первая кнопка - основная кнопка
+
|  '''MB_DEFBUTTON1'''<br>0x0       ||  Первая кнопка - основная кнопка
 
|-
 
|-
−
|  '''MB_DEFBUTTON2'''<br>0x0  ||  Вторая кнопка - основная кнопка
+
|  '''MB_DEFBUTTON2'''<br>0x256      ||  Вторая кнопка - основная кнопка
 
|-
 
|-
−
|  '''MB_DEFBUTTON3'''<br>0x0  ||  Третья кнопка - основная кнопка
+
|  '''MB_DEFBUTTON3'''<br>0x512      ||  Третья кнопка - основная кнопка
 
|-
 
|-
−
|  '''MB_DEFBUTTON4'''<br>0x0  ||  Четвёртая кнопка - основная кнопка
+
|  '''MB_DEFBUTTON4'''<br>0x768      ||  Четвёртая кнопка - основная кнопка
 +
|-
 +
|  '''MB_RIGHT'''<br>0x524288        ||  Выравнивание всего текста в окне по правому краю
 
|}
 
|}
  
 
<br/>
 
<br/>
 
====Список возвращаемых значений====
 
====Список возвращаемых значений====
−
{| border="1" cellpadding="5" style="background-color:#ffffdd;"
+
{| border="1" cellpadding="3" style="background-color:#ffffdd;"
 
!  Флаг                                !! Значение
 
!  Флаг                                !! Значение
 
|-
 
|-
−
! style="color:red;background-color:#ffffcc;" colspan="2"|ффф
+
|  '''IDABORT'''<br>0x3      ||  Была нажата кнопка "Прервать" (Abort)
 +
|-
 +
|  '''IDCANCEL'''<br>0x2    ||  Была нажата кнопка "Отменить" (Cancel)
 +
|-
 +
|  '''IDCONTINUE'''<br>0x11  ||  Была нажата кнопка "Продолжить" (Continue)
 +
|-
 +
|  '''IDIGNORE'''<br>0x5  ||  Была нажата кнопка "Игнорировать" (Ignore)
 +
|-
 +
|  '''IDNO'''<br>0x7  ||  Была нажата кнопка "Нет" (No)
 +
|-
 +
|  '''IDOK'''<br>0x1  ||  Была нажата кнопка "OK"
 +
|-
 +
|  '''IDRETRY'''<br>0x4  ||  Была нажата кнопка "Повтор" (Retry)<br>актуально для флагов MB_ABORTRETRYIGNORE, MB_RETRYCANCEL
 
|-
 
|-
−
|  '''MB_ABORTRETRYIGNORE'''<br>0x2    ||  Кнопки: ''Прервать, Повтор, Пропустить''
+
|  '''IDTRYAGAIN'''<br>0x10  ||  Была нажата кнопка "Повторить" (Try Again)<br>актуально для флага с кодом 6 (MB_CANCELTRYCONTINUE)
 
|}
 
|}
 +
<br>
 +
Если окно сообщений имеет кнопку Отменить (Cancel), функция возвращает значение IDCANCEL тогда, если или нажата клавиша ESC, или выбрана кнопка Cancel. Если у окна сообщений нет кнопки Cancel, нажатие на ESC не имеет никакого эффекта.

Версия 12:19, 4 августа 2015

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

Синтаксис

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_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)
актуально для флага с кодом 6 (MB_CANCELTRYCONTINUE)


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

Источник — «http://wiki.gbsoft.ru/index.php?title=MESSAGEBOX&oldid=2830»