Fluent-Qt

API リファレンス

FormController

GUI スレッド上で Field コントロールのグループ全体の変更状態、検証、および送信を調整します。validationRequested() に対しては completeValidation() で応答し、値が更新されるたびに markFieldChanged() を呼び出してください。

fluent::FormController

継承元 QObject

コンストラクタ

デストラクタ

メソッド

bool addField(const QString& key, layout::Field* 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() を 1 回発行します。すでに送信中の場合は無視されます。

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