Fluent-Qt

Référence API

FormController

Coordonne l'état modifié, la validation et l'envoi pour un groupe de contrôles Field sur le thread GUI. Répondez à validationRequested() avec completeValidation() et appelez markFieldChanged() à chaque mise à jour de valeur.

fluent::FormController

Hérite de QObject

Constructeurs

Destructeurs

Méthodes

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

Enregistre un Field sous une clé unique (le champ reste détenu par l'application).

void markFieldChanged(const QString& key)

Marque un champ comme modifié et invalide les jetons de validation ou de soumission en attente.

void markClean()

Marque tous les champs enregistrés comme intacts sans modifier les valeurs des éditeurs.

void reset()

Réinitialise l'état de suivi du contrôleur sans modifier les valeurs de l'éditeur.

quint64 validateField(const QString& key)

Demande la validation pour @p key et retourne un jeton pour completeValidation().

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

Termine une validation en attente correspondant à @p token ; un @p message vide en cas de succès efface l'indication d'erreur.

bool submit()

Valide tous les champs et émet submitRequested() une fois si tous réussissent ; ignoré si une soumission est déjà en cours.

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

Termine la soumission active ; marque les champs comme non modifiés en cas de succès et conserve les modifications en cas d'échec.

bool focusFirstError()

Donne le focus au premier éditeur de champ invalide selon l'ordre d'enregistrement.

Propriétés

bool dirty
Lecture isDirty()Notification stateChanged()
bool touched
Lecture isTouched()Notification stateChanged()
bool validating
Lecture isValidating()Notification stateChanged()
bool submitting
Lecture isSubmitting()Notification stateChanged()
bool valid
Lecture isValid()Notification stateChanged()
QStringList errorMessages
Lecture errorMessages()Notification stateChanged()
QString submissionError
Lecture submissionError()Notification stateChanged()

Signaux

Documentation de la classe de base Qt : QObject