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(). Если метод будет вызван повторно, но с другим текстом, текст сообщения будет изменён.

Если showInfoForm() вызван внутри withInfoForm(), его сообщение временно заменяет видимый текст withInfoForm(). Такое сообщение можно закрыть через hideInfoForm(). Если этого не сделать, оно будет закрыто автоматически при завершении соответствующего withInfoForm().

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. Если вызвать withInfoForm() внутри другого withInfoForm(), пользователь увидит сообщение внутреннего вызова. При завершении внутреннего вызова снова показывается сообщение внешнего вызова, а при завершении внешнего вызова восстанавливается сообщение, которое было показано до него, либо окно скрывается.

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

Parameters:

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

Throws:

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

Returns:

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