Модуль графического интерфейса

Модуль предназначен для создания и вызова разного рода диалоговых окон. Модуль построен на основе библиотеки Qt.

Типы текстовых полей InputType

InputType.STRING Строковое поле ввода

InputType.DATE Поле для ввода даты

InputType.TIME Поле для ввода времени

InputType.DATE_TIME Поле для ввода даты и времени

InputType.DOUBLE Поле для ввода вещественного числа

InputType.BOOLEAN Поле для ввода логического значения

InputType.INT Поле для ввода целочисленного значения

Цвета текстовых полей ChemicColors

ChemicColors.INPUT_REQUIRED Поле ввода, обязательное для заполнения (желтое)

Класс InputDialog

Класс предназначенный для конструирования произвольных диалогов ввода информации

makeInput()

Создание однострочного поля ввода с указанным типом

type: InputType Тип поля ввода return: InputElement Созданный элемент ввода

makeInput(type: InputType): InputElement;

makeCombo()

Создание поля ввода в виде выпадающего списка

return: InputCombo Созданный элемент выпадающего списка

makeCombo(): InputCombo;

setTitle()

Установка заголовка окна диалога

title: string Заголовок окна

setTitle(title: string): void;

setBackground()

Установка цвета фона диалога

color: string HEX код цвета или его название

setBackground(color: string): void;

setMinimumWidth()

Установка минимальной ширина диалога

width: number Ширина в пикселях

setMinimumWidth(width: number): void;

setMinimumHeight()

Установка минимальной высоты диалога

height: number Высота в пикселях

setMinimumHeight(height: number): void;

on()

Установка обработчика события

event: string Имя события

handler: function Функция, вызываемая для обработки события

on(event: 'confirm', handler: () => boolean): void;

show()

Вызывает сформированный диалог и возвращает результат

return: boolean Результат действий пользователя (true - если пользователь нажал ОК, false - в любой другой ситуации)

show(): boolean;

Класс InputElement

label

Наименование поля, отображается слева

label: string;

isReadOnly

Флаг - поле только для чтения

isReadOnly: boolean;

value

Текущее значение поля ввода

value: null | number | boolean | string | Date;

on()

Установка обработчика события

event: string Имя события

handler: function Функция, вызываемая для обработки события

on(event: 'change', handler: (value: null | number | boolean | string | Date) => void): void;

setBackground()

Установка цвета фона элемента ввода

color: string HEX код цвета или его название

setBackground(color: string): void

Класс InputCombo

Нужен для Наследует InputElement.

selectedIndex

Порядковый номер выбранного элемента из выпадающего списка

selectedIndex: number | null

addValues()

Добавление элементов в выпадающий список

values: Array<number | boolean | string | Date> Массив элементов (элементы преобразуются в строку после установки)

addValues(values: Array<number | boolean | string | Date>): void;

clear()

Очистка содержимого выпадающего списка

clear(): void;

Функция openFile()

Выводит диалог выбора файла (единичного) для открытия

defaultDirectory: string | null Директория по умолчанию

filters: string Фильтры для списка файлов пример: Изображения (*.png *.xpm *.jpg);;Текстовые файлы (*.txt)

return: string | null Путь к выбранному файлу

function openFile(defaultDirectory: string | null, filters?: string): string | null;

Функция openFiles()

Выводит диалог выбора файлов для открытия

defaultDirectory: string | null Директория по умолчанию

filters: string Фильтры для списка файлов пример: Изображения (*.png *.xpm *.jpg);;Текстовые файлы (*.txt)

return: string[] | null Путь к выбранному файлу

function openFiles(defaultDirectory: string | null, filters?: string): string[] | null;

Функция saveFile()

Выводит диалог выбора пути к сохраняемому файлу

defaultDirectory: string | null Директория по умолчанию

filters: string Фильтры для списка файлов пример: Изображения (*.png *.xpm *.jpg);;Текстовые файлы (*.txt)

return: string[] | null Путь к сохраняемому файлу

function saveFile(defaultDirectory: string | null, filters?: string): string | null;

Функция showPopup()

Выводит всплывающее уведомление в нижней правой части экрана

content: any Данные для вывода в всплывающем сообщении

options: PopupOptions Параметры всплывающего сообщения

function showPopup(content: any, options?: PopupOptions): void;

Параметры для всплывающих окон

interface PopupOptions {
  isAutoHide: boolean; // Скрывать ли окно автоматически
}

Функция createSplashWindow()

Создает окно с индикатором загрузки

Доступно только при наличии splash.exe

text: string Подпись к индикатору

return: SplashWindow

function createSplashWindow(text?: string): SplashWindow;

Интерфейс загрузочного экрана

interface SplashWindow {
  close: () => void;
}

Пространство имен MessageBox

Внутри пространства имен содержится функция показа диалогового окна и его параметры для настройки.

Функция show()

text: string текст сообщения title: string заголовок окна flags: Buttons | Icons | Utils запись через битовую операцию или |

function show(text: string, title?: string, flags?: Buttons | Icons): Results;

Возможные результаты

Results.ABORT Прервать

Results.CANCEL Отмена

Results.CONTINUE Продолжить

Results.IGNORE Игнорировать

Results.YES Да

Results.NO Нет

Results.OK Ок

Results.RETRY Повтор

Results.TRYAGAIN Повторить

Настройка кнопок

Buttons.ABORT_RETRY_IGNORE Прервать, повтор, пропустить

Buttons.CANCEL_TRY_CONTINUE Отмена, повторить, продолжить

Buttons.OK Ок

Buttons.OK_CANCEL Ок, отмена

Buttons.RETRY_CANCEL Повтор, отмена

Buttons.YES_NO Да, нет

Настройка иконок

Icons.ERROR Ошибка

Icons.QUESTION Вопрос

Icons.WARNING Предупреждение

Icons.INFO Информация

Дополнительные настройки

Utils.ALWAYS_ON_TOP Принудительный вывод окна сообщения на переднем плане