API 參考
FormController
在 GUI 執行緒上協調一組 Field 控制項的變更狀態、驗證與提交。收到 validationRequested() 時以 completeValidation() 回應,並在每次數值更新時呼叫 markFieldChanged()。
沒有符合的 API 成員。
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