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.
Keine passenden API-Elemente.
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()BenachrichtigungstateChanged() bool touched- Lesen
isTouched()BenachrichtigungstateChanged() bool validating- Lesen
isValidating()BenachrichtigungstateChanged() bool submitting- Lesen
isSubmitting()BenachrichtigungstateChanged() bool valid- Lesen
isValid()BenachrichtigungstateChanged() QStringList errorMessages- Lesen
errorMessages()BenachrichtigungstateChanged() QString submissionError- Lesen
submissionError()BenachrichtigungstateChanged()
Signale
Qt-Basisklassendokumentation: QObject