Fluent-Qt

API 參考

FormController

在 GUI 執行緒上協調一組 Field 控制項的變更狀態、驗證與提交。收到 validationRequested() 時以 completeValidation() 回應,並在每次數值更新時呼叫 markFieldChanged()。

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() 使用的 token。

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