Fluent-Qt

Справочник API

FormController

Координирует состояние изменений, валидацию и отправку для группы элементов Field в потоке GUI. Отвечайте на validationRequested() вызовом completeValidation() и вызывайте markFieldChanged() при каждом обновлении значения.

fluent::FormController

Наследует QObject

Конструкторы

Деструкторы

Методы

bool addField(const QString& key, layout::Field* field)

Регистрирует Field под уникальным ключом (поле остаётся во владении приложения).

void markFieldChanged(const QString& key)

Помечает поле как изменённое и делает недействительными ожидающие токены проверки или отправки.

void markClean()

Помечает все зарегистрированные поля как неизменённые без изменения значений редакторов.

void reset()

Сбрасывает состояние отслеживания контроллера без изменения значений редакторов.

quint64 validateField(const QString& key)

Запрашивает валидацию для @p key и возвращает токен для completeValidation().

bool completeValidation(const QString& key, quint64 token, bool valid, const QString& message = QString())

Завершает ожидающую проверку, соответствующую @p token; пустой @p message при успехе очищает сообщение об ошибке.

bool submit()

Проверяет все поля и однократно отправляет submitRequested(), если все проверки пройдены; игнорируется при уже выполняющейся отправке.

bool completeSubmit(quint64 token, bool success, const QString& message = QString())

Завершает активную отправку; при успехе сбрасывает флаг изменения полей, а при ошибке сохраняет правки.

bool focusFirstError()

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

Свойства

bool dirty
Чтение isDirty()Уведомление stateChanged()
bool touched
Чтение isTouched()Уведомление stateChanged()
bool validating
Чтение isValidating()Уведомление stateChanged()
bool submitting
Чтение isSubmitting()Уведомление stateChanged()
bool valid
Чтение isValid()Уведомление stateChanged()
QStringList errorMessages
Чтение errorMessages()Уведомление stateChanged()
QString submissionError
Чтение submissionError()Уведомление stateChanged()

Сигналы

Документация базового класса Qt: QObject