Справочник API
FormController
Координирует состояние изменений, валидацию и отправку для группы элементов Field в потоке GUI. Отвечайте на validationRequested() вызовом completeValidation() и вызывайте markFieldChanged() при каждом обновлении значения.
Нет подходящих элементов API.
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