Fluent-Qt

API-Referenz

FormController

Koordiniert Änderungsstatus, Validierung und Übermittlung über eine Gruppe von Field-Steuerelementen im GUI-Thread. Reagieren Sie auf validationRequested() mit completeValidation() und rufen Sie bei jeder Wertänderung markFieldChanged() auf.

fluent::FormController

Erbt von QObject

Konstruktoren

Destruktoren

Methoden

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

Registriert ein Field unter einem eindeutigen Schlüssel (das Feld bleibt im Besitz der Anwendung).

void markFieldChanged(const QString& key)

Markiert ein Feld als geändert und macht ausstehende Validierungs- oder Übermittlungstoken ungültig.

void markClean()

Markiert alle registrierten Felder als unverändert, ohne Editorwerte zu ändern.

void reset()

Setzt den Verfolgungsstatus des Controllers zurück, ohne die Editorwerte zu ändern.

quint64 validateField(const QString& key)

Fordert eine Validierung für @p key an und gibt ein Token für completeValidation() zurück.

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

Schließt eine zu @p token passende ausstehende Validierung ab; bei Erfolg löscht ein leeres @p message den Fehlerhinweis.

bool submit()

Validiert alle Felder und sendet einmalig submitRequested(), wenn alle gültig sind; wird während einer laufenden Übermittlung ignoriert.

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

Schließt die aktive Übermittlung ab; markiert Felder bei Erfolg als unverändert und behält Änderungen bei Fehlschlag bei.

bool focusFirstError()

Fokussiert den ersten ungültigen Feldeditor in Registrierungsreihenfolge.

Eigenschaften

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

Signale

Qt-Basisklassendokumentation: QObject