CoreDialogs¶

public interface CoreDialogs¶: Набор методов, открывающих различные диалоги.

Methods¶

hideInfoForm¶

void hideInfoForm()¶

Скрывает открытое ранее методом showInfoForm() информационое сообщение.

Throws:

ApplicationException – Если что-то пошло не так.

showButtonsDialog¶

long showButtonsDialog(String caption, String text, long colCount, ListValObj buttons, String imageCollectionName, long focusButtonNumber)¶

Added in version 1.8.0-ms4.

Added in version 1.27.0-ms17: Кнопка, указанная в параметре focusButtonNumber, отображается последней в крайнем правом нижнем положении.

Данный метод вызывает диалоговое окно и возвращает номер нажатой кнопки. Нумерация кнопок начинается с 0. Если нажата клавиша ESC, то вернет -1.

Parameters:

caption – Заголовок окна. Если тексту заголовка соответствует один из элементов [[MsgDlgEnum]] в окно будет добавлена соответствующая иконка. Если соответствия нет, окно будет показано без иконок.
text – Информационный текст для пользователя
colCount – Количество кнопок в строке. Если указано значение меньше единицы или null, используется значение по умолчанию - 2. Кнопки размещаются слева-направо, сверху-вниз.
buttons – Массив кнопок. Каждая кнопка описывается JSON-объектом. Формат описания: {“caption”: _, “index”: _, “enable”: _} caption - Текст на кнопке. index - пиктограма, порядковый номер изображения в коллекции. Если значение равно -1, то кнопка будет без картинки. enable - Активность кнопки. Последние 2 параметра необязательны. Если они не заданы, то кнопка будет без изображения и/или активна.
imageCollectionName – Системное имя коллекции изображения, откуда берутся пиктограмы кнопок
focusButtonNumber – Номер кнопки в фокусе. Если данная кнопка неактивна, то в фокусе будет первая активная кнопка. Кнопка, указанная в этом параметре, отображается последней в крайнем правом нижнем положении, независимо от ее порядкового номера в переданном списке.

Throws:

ApplicationException – Если что-то пошло не так.

Returns:

номер нажатой кнопки

showButtonsDialog¶

long showButtonsDialog(String caption, String text, List<List<java.lang.Object>> buttons, String imageCollectionName, long focusButtonNumber)¶

Deprecated since version Устаревшая: версия метода [[showButtonsDialog]]. Отличается отсутствием параметра colCount и способом передачи списка кнопок.

Parameters:

caption – Заголовок окна. Если тексту заголовка соответствует один из элементов [[MsgDlgEnum]] в окно будет добавлена соответствующая иконка. Если соответствия нет, окно будет показано без иконок.
text – Информационный текст для пользователя
buttons – Массив кнопок. Каждая кнопка описывается вложенным массивом. Формат описания: [‘Text’, Imageindex, isEnabled] Text - Текст на кнопке. Imageindex - пиктограма, порядковый номер изображения в коллекции. Если значение равно -1, то кнопка будет без картинки. Enabled - Активность кнопки. Последние 2 параметра необязательны. Если они не заданы, то кнопка будет без изображения и/или активна.
imageCollectionName – Системное имя коллекции изображения, откуда берутся пиктограмы кнопок
focusButtonNumber – Номер кнопки в фокусе. Если данная кнопка неактивна, то в фокусе будет первая активная кнопка.

Throws:

ApplicationException – Если что-то пошло не так.

Returns:

Номер нажатой кнопки

showEditPaintStyleDialog¶

String showEditPaintStyleDialog(String styleInDelphiFormat)¶

Метод вызывает диалог настройки стиля раскраски.

Диалог позволяет выбрать существующий стиль, либо сформировать произвольный, задав шрифт текста, размер, начертание, цвет и фон текста. При закрытии модального окна настройки стиля по кнопки “OK” возвращаются настройки стиля в виде строки, если сформирован произвольный стиль, либо возвращается имя стиля из реестра, если выбран существующий стиль.

При закрытии по кнопке “Отмена” будет возращена строка переданная в качестве параметра конструктору диалога. В качестве AStyle может

Примеры EditStyleDlg(“C=clred;FN=Terminal;FS=12;FC=$440033;FB=1;FI=1;FU=0;FO=1;”); EditStyleDlg(“Btk_AppStyle”);

Parameters:

styleInDelphiFormat – Строковое описание стиля в виде “C=clred;FN=Terminal;FS=12; FC=$440033;FB=1;FI=1;FU=0;FO=1;”, либо имя стиля. Передача всех свойств стиля в строке не обязательна. * С - Цвет фона; FN - название шрифта; FC - цвет шрифта; FS - размер шрифта; * Свойства начертания, логического типа: FB - жирный; FI - курсив; FU - подчеркнутый; FS - зачеркнутый;

Throws:

ApplicationException – Если что-то пошло не так.

Returns:

стиль в делфи форматирование, либо имя предопределенного в системе стиля.

showInfoForm¶

void showInfoForm(String msg)¶

Отображает информационное сообщение с текстом msg. Сообщение будет видимо до тех пор, пока не будет вызван метод hideInfoForm(). Если метод будет вызван повторно, но с другим текстом, текст сообщения будет изменён.

Parameters:

msg – Текст сообщения

Throws:

ApplicationException – Если что-то пошло не так.

showMessage¶

void showMessage(String message)¶

Отображает диалог с текстовым сообщением и единственной кнопкой “OK”

Parameters:

message – Сообщение диалога

Throws:

ApplicationException – Если что-то пошло не так.

showMsgDialog¶

MsgDlgButtonEnum showMsgDialog(MsgDlgEnum msgDlgEnum, String text, List<MsgDlgButtonEnum> buttons)¶

Открывает диалог указанного типа с сообщением.

Parameters:

msgDlgEnum – Тип диалога, определяет иконку.
text – Тескт сообщения
buttons – Перечень кнопок

Throws:

ApplicationException – Если что-то пошло не так.

Returns:

Результат нажатой кнопки

showMsgDialog¶

MsgDlgButtonEnum showMsgDialog(MsgDlgEnum msgDlgEnum, String text, List<MsgDlgButtonEnum> buttons, MsgDlgButtonEnum focusButton)¶

Открывает диалог указанного типа с сообщением.

Parameters:

msgDlgEnum – Тип диалога, определяет иконку.
text – Тескт сообщения
buttons – Перечень кнопок
focusButton – Идентификатор кнопки, на которой будет установлен фокус

Throws:

ApplicationException – Если что-то пошло не так.

Returns:

Результат нажатой кнопки

showPromptDialog¶

String showPromptDialog(String caption, String text, String defaultText)¶

Открывает диалог с запросом ввода строки.

Parameters:

caption – Заголовок диалога
text – Текст сообщения
defaultText – Тест по умолчанию

Throws:

ApplicationException – Если что-то пошло не так.

Returns:

Текст введённый в поле ввода

withConfirmation¶

<R> R withConfirmation(String msg, ForwardFunction<R> f)¶

Отображает диалог с подтверждением действия.

Parameters:

msg – Сообщение диалога подтверждения действия
f – Метод
<R> – Тип результата метода

Throws:

ApplicationException – Если что-то пошло не так.

Returns:

результат метода f

withInfoForm¶

<R> R withInfoForm(String msg, ForwardFunction<R> f)¶

Отображает информационное сообщение с текстом msg перед выполнением метода f и скрывает сообщение по завершении выполнения метода f

!!! ВНИМАНИЕ!!! Все отправки изменений клиенту приостанавливаются до окончания выполнения метода

Parameters:

msg – Сообщение
f – Метод
<R> – Тип результат метода

Throws:

ApplicationException – Если что-то пошло не так.

Returns:

результат метода f