|
|
|
|
Отображает модальное диалоговое окно, имеющее системный значок, набор кнопок и краткое сообщение.
Синтаксис
| function MessageBox(
| | hWnd, | | Text, | | Caption, | | Type
| | ): Number;
|
| Параметры
|
| Параметр
| Тип
| Описание
|
| hWnd
| Number
| дескриптор родительского окна или null
|
| Text
| String
| текст сообщения
|
| Caption
| String
| заголовок окна сообщения
|
| Type
| Enumset
| комбинируемые флаги, определяющие состав отображаемых кнопок и значок сообщения (см. ниже)
|
|
| Параметр Type
|
| Значение
| Описание
|
| Отображение кнопок
| [DESC]
|
| MB_ABORTRETRYIGNORE
| показать кнопки Прервать, Повторить и Пропустить
|
| MB_CANCELTRYCONTINUE
| показать кнопки Отмена, Повторить попытку и Продолжить
|
| MB_HELP
| показать кнопку Справка (при нажатии этой кнопки или клавиши F1 родительское окно получит сообщение WM_HELP)
|
| MB_OK
| показать кнопку ОК (значение по умолчанию)
|
| MB_OKCANCEL
| показать кнопку Отмена
|
| MB_RETRYCANCEL
| показать кнопки Повторить и Отмена
|
| MB_YESNO
| показать кнопки Да и Нет
|
| MB_YESNOCANCEL
| показать кнопки Да, Нет и Отмена
|
| Отображение значка сообщения
| [DESC]
|
| MB_ICONASTERISK
| показать значок, состоящий из строчной буквы i в круге
|
| MB_ICONEXCLAMATION
| показать значок восклицательного знака
|
| MB_ICONHAND
| показать значок стоп-знака
|
| MB_ICONQUESTION
| показать значок вопросительного знака
|
| MB_ICONERROR
| см. значение MB_ICONHAND
|
| MB_ICONSTOP
| см. значение MB_ICONHAND
|
| MB_ICONINFORMATION
| см. значение MB_ICONASTERISK
|
| MB_ICONWARNING
| см. значение MB_ICONEXCLAMATION
|
| Назначение кнопок по умолчанию
| [DESC]
|
| MB_DEFBUTTON1
| 1-я кнопка является кнопкой по умолчанию
|
| MB_DEFBUTTON2
| 2-я кнопка является кнопкой по умолчанию
|
| MB_DEFBUTTON3
| 3-я кнопка является кнопкой по умолчанию
|
| MB_DEFBUTTON4
| 4-я кнопка является кнопкой по умолчанию
|
| Модальность окна сообщения
| [DESC]
|
| MB_APPLMODAL
| необходимо ответить на окно сообщения, прежде чем продолжить работу в родительском окне, однако можно переходить в окна других потоков приложения
|
| MB_SYSTEMMODAL
| аналогично значению MB_APPLMODAL, однако окно сообщения имеет стиль WS_EX_TOPMOST
|
| MB_TASKMODAL
| аналогично значению MB_APPLMODAL, однако все окна верхнего уровня, принадлежащие текущему потоку, отключены, если параметр hWnd имеет значение null
|
| Прочие свойства
| [DESC]
|
| MB_DEFAULT_DESKTOP_ONLY
| функция ожидает переключения на рабочий стол по умолчанию, если текущий рабочий стол не является таковым
|
| MB_RIGHT
| выровнять текст сообщения по правому краю
|
| MB_RTLREADING
| показать сообщение справа налево в системах иврита и арабского языка
|
| MB_SETFOREGROUND
| сделать окно сообщения окном переднего плана
|
| MB_TOPMOST
| присвоить окну сообщения стиль WS_EX_TOPMOST
|
|
| Возвращаемое значение
|
| Значение
| Описание
|
| 0
| ошибка при выполнении функции
|
| IDABORT
| нажата кнопка Прервать
|
| IDCANCEL
| нажата кнопка Отмена или клавиша Escape
|
| IDCONTINUE
| нажата кнопка Продолжить
|
| IDIGNORE
| нажата кнопка Пропустить
|
| IDNO
| нажата кнопка Нет
|
| IDOK
| нажата кнопка ОК или клавиша Escape
|
| IDRETRY
| нажата кнопка Повторить
|
| IDTRYAGAIN
| нажата кнопка Повторить попытку
|
| IDYES
| нажата кнопка Да
|
|
// Главная форма
frm=new TForm();
frm.Caption="JS+ - функция WinAPI MessageBox";
frm.Width =450;
frm.Height=300;
// Строка состояния
stb=new TStatusBar(frm);
stb.SimpleText=' Нажмите кнопку "Завершить работу"';
// Кнопка
btn=new TButton(frm);
btn.Caption="Завершить работу";
btn.Width=btn.TextWidth(btn.Caption)+20;
btn.Left=(frm.ClientWidth-btn.Width)/2;
btn.Top =(stb.Top-btn.Height)/2;
btn.OnClick=btn_Click;
frm.ShowModal();
// Обработчик события OnClick
function btn_Click(btn)
{
if (MessageBox(null,"Внимание!\nЗавершение сеанса работы текущего пользователя","JS+",MB_YESNO+MB_ICONQUESTION)==IDYES)
ExitWindows(0,0);
}
|
Совместимость
Windows API
|
| JS+ | Руководство пользователя
|
|
|
| |
|
|
