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()에 사용할 토큰을 반환합니다.

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