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

Материал из GB wiki
Перейти к: навигация, поиск
 
(не показано 8 промежуточных версий этого же участника)
Строка 13: Строка 13:
 
}}<br/>{{Аргумент
 
}}<br/>{{Аргумент
 
  |Название=флаги
 
  |Название=флаги
−
  |Пояснение=целое, флаг (или комбинация флагов), определяющий стиль диалогового окна: внешний вид, набор кнопок и другие параметры. Можно использовать именованные константы совместно с функцией TYPE, так и их числовые значения. [[#Список значений флагов|Список возможных флагов]] смотрите ниже.
+
  |Пояснение=целое, флаг (или комбинация флагов), определяющий стиль диалогового окна: внешний вид, набор кнопок и другие параметры. Можно использовать как именованные константы совместно с функцией [[TYPE]], так и их числовые значения. [[#Список значений флагов|Список возможных флагов]] смотрите ниже.
 
}}
 
}}
 
|Результат=целое. Список [[#Список возвращаемых значений|возвращаемых значений]] смотрите ниже.
 
|Результат=целое. Список [[#Список возвращаемых значений|возвращаемых значений]] смотрите ниже.
 
|Пример=Пример 1.
 
|Пример=Пример 1.
−
<br/>MessageBox('Текст в диалоговом окне', 'Заголовок окна', Type(MB_OKCANCEL))
+
<br/>MessageBox(`Текст в диалоговом окне`, `Заголовок окна`, Type(MB_OKCANCEL))
 
<br/>или
 
<br/>или
−
<br/>MessageBox('Текст в диалоговом окне', 'Заголовок окна', 1)
+
<br/>MessageBox(`Текст в диалоговом окне`, `Заголовок окна`, 1)
 
<br/>[[Файл:MessageBox1.PNG]]
 
<br/>[[Файл:MessageBox1.PNG]]
  
 
<br/>Пример 2.
 
<br/>Пример 2.
−
<br/>MessageBox('Текст в диалоговом окне', 'Заголовок окна', Type(MB_OKCANCEL + MB_ICONWARNING))
+
<br/>MessageBox(`Текст в диалоговом окне`, `Заголовок окна`, Type(MB_OKCANCEL + MB_ICONWARNING))
 
<br/>[[Файл:MessageBox2.PNG]]
 
<br/>[[Файл:MessageBox2.PNG]]
 
}}
 
}}
Строка 36: Строка 36:
 
|  '''MB_ABORTRETRYIGNORE'''<br>0x2    ||  Кнопки: ''Прервать, Повтор, Пропустить''
 
|  '''MB_ABORTRETRYIGNORE'''<br>0x2    ||  Кнопки: ''Прервать, Повтор, Пропустить''
 
|-
 
|-
−
| MB_CANCELTRYCONTINUE<br>0x6<br>''в ГБ именованный флаг не определён, используйте его код = 6''  ||  Кнопки: ''Отмена, Повторить, Продолжить''
+
| <span style="color:gray;"> '''MB_CANCELTRYCONTINUE'''</span> <br>0x6<br>''в ГБ именованный флаг не определён, используйте его код = 6''  ||  Кнопки: ''Отмена, Повторить, Продолжить''
 
|-
 
|-
 
|  '''MB_OK'''<br>0x0                  ||  Кнопка: ''OK''
 
|  '''MB_OK'''<br>0x0                  ||  Кнопка: ''OK''
Строка 50: Строка 50:
 
! style="color:red;background-color:#ffffcc;" colspan="2"|Флаги для пиктограмм (иконок)
 
! style="color:red;background-color:#ffffcc;" colspan="2"|Флаги для пиктограмм (иконок)
 
|-
 
|-
−
|  '''MB_ICONEXCLAMATION'''<br>'''MB_ICONWARNING'''<br>0x48   ||  [[Файл:MessageBoxWarn.PNG]] ''Предупреждение''
+
|  '''MB_ICONEXCLAMATION'''<br>'''MB_ICONWARNING'''<br>0x48             ||  [[Файл:MessageBoxWarn.PNG]] ''Предупреждение''
 
|-
 
|-
−
|  '''MB_ICONINFORMATION'''<br>'''MB_ICONASTERISK'''<br>0x64 ||  [[Файл:MessageBoxInfo.PNG]] ''Информация.'
+
|  '''MB_ICONINFORMATION'''<br>'''MB_ICONASTERISK'''<br>0x64             ||  [[Файл:MessageBoxInfo.PNG]] ''Информация''
 
|-
 
|-
−
|  '''MB_ICONQUESTION'''<br>0x32                             ||  [[Файл:MessageBoxQuest.PNG]] ''Вопрос''
+
|  '''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"|Прочие флаги
Строка 74: Строка 76:
 
!  Флаг                                !! Значение
 
!  Флаг                                !! Значение
 
|-
 
|-
−
|  '''IDABORT'''<br>0x3      ||  Была нажата кнопка "Прервать" (Abort)
+
|  '''IDOK'''<br>0x1  ||  Была нажата кнопка "OK"
 
|-
 
|-
 
|  '''IDCANCEL'''<br>0x2    ||  Была нажата кнопка "Отменить" (Cancel)
 
|  '''IDCANCEL'''<br>0x2    ||  Была нажата кнопка "Отменить" (Cancel)
 
|-
 
|-
−
|  '''IDCONTINUE'''<br>0x11 ||  Была нажата кнопка "Продолжить" (Continue)
+
|  '''IDABORT'''<br>0x3      ||  Была нажата кнопка "Прервать" (Abort)
 +
|-
 +
|  '''IDRETRY'''<br>0x4 ||  Была нажата кнопка "Повтор" (Retry)<br>актуально для флагов MB_ABORTRETRYIGNORE, MB_RETRYCANCEL
 
|-
 
|-
 
|  '''IDIGNORE'''<br>0x5  ||  Была нажата кнопка "Игнорировать" (Ignore)
 
|  '''IDIGNORE'''<br>0x5  ||  Была нажата кнопка "Игнорировать" (Ignore)
 +
|-
 +
|  '''IDYES'''<br>0x6  ||  Была нажата кнопка "Да" (Yes)
 
|-
 
|-
 
|  '''IDNO'''<br>0x7  ||  Была нажата кнопка "Нет" (No)
 
|  '''IDNO'''<br>0x7  ||  Была нажата кнопка "Нет" (No)
 
|-
 
|-
−
|  '''IDOK'''<br>0x1 ||  Была нажата кнопка "OK"
+
|  '''IDTRYAGAIN'''<br>0x10 ||  Была нажата кнопка "Повторить" (Try Again)<br>актуально для флага MB_CANCELTRYCONTINUE
−
|-
 
−
|  '''IDRETRY'''<br>0x4  ||  Была нажата кнопка "Повтор" (Retry)<br>актуально для флагов MB_ABORTRETRYIGNORE, MB_RETRYCANCEL
 
 
|-
 
|-
−
|  '''IDTRYAGAIN'''<br>0x10 ||  Была нажата кнопка "Повторить" (Try Again)<br>актуально для флага с кодом 6 (MB_CANCELTRYCONTINUE)
+
|  '''IDCONTINUE'''<br>0x11 ||  Была нажата кнопка "Продолжить" (Continue)
 
|}
 
|}
 
<br>
 
<br>
−
Если окно сообщений имеет кнопку Отменить (Cancel), функция возвращает значение IDCANCEL тогда, если или нажата клавиша ESC, или выбрана кнопка Cancel. Если у окна сообщений нет кнопки Cancel, нажатие на ESC не имеет никакого эффекта.
+
<p style="text-indent:40px;">Если диалоговое окно содержит кнопку "Отмена" (Cancel), то функция возвращает значение IDCANCEL в том случае, если нажата либо клавиша ESC, либо кнопка "Отмена". Если у окна сообщений нет кнопки "Отмена", нажатие на ESC не имеет никакого эффекта.</p>

Текущая версия на 12:36, 13 мая 2019

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

Синтаксис

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 не имеет никакого эффекта.

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