QValidator Class

상세 설명

클래스 자체는 추상적입니다. 두 개의 서브 클래스 QIntValidator 와 QDoubleValidator 는 기본적인 숫자 범위 검사를 제공하고 QRegularExpressionValidator 는 사용자 정의 정규식을 사용한 일반 검사를 제공합니다.

기본 제공 유효성 검사기로 충분하지 않은 경우 QValidator를 서브 클래싱할 수 있습니다. 이 클래스에는 validate() 및 fixup() 두 개의 가상 함수가 있습니다.

validate()는 모든 서브클래스에서 구현해야 합니다. 이 함수는 인수가 유효한지 여부에 따라 Invalid, Intermediate 또는 Acceptable 를 반환합니다(서브클래스의 유효 정의에 따라).

이 세 가지 상태는 약간의 설명이 필요합니다. Invalid 문자열은 명백히 유효하지 않습니다. Intermediate 문자열이 불완전(아직 편집 중)한 경우 유효성 개념을 적용하기 어렵기 때문에 덜 명확합니다. QValidator는 Intermediate 을 명확하게 유효하지도 않고 최종 결과로 허용되지도 않는 문자열의 속성으로 정의합니다. Acceptable 은 해당 문자열이 최종 결과로 허용됨을 의미합니다. Acceptable 문자열을 입력하는 동안 그럴듯한 중간 상태인 모든 문자열은 Intermediate 이라고 말할 수 있습니다.

다음은 몇 가지 예입니다:

• 10부터 1000까지의 정수를 허용하는 줄 편집의 경우 42와 123은 Acceptable, 빈 문자열인 5 또는 1234는 Intermediate, "asdf" 및 10114는 Invalid 입니다.
• URL을 허용하는 편집 가능한 콤보박스의 경우 올바른 형식의 URL은 Acceptable, "http://example.com/"은 Intermediate (실수로 끝에 쉼표가 들어간 잘라내기 및 붙여넣기 작업일 수 있음), 빈 문자열은 Intermediate (사용자가 새 URL을 입력할 준비를 위해 모든 텍스트를 선택하고 삭제할 수 있음) 및 "http:///./"은 Invalid 입니다.
• 길이를 허용하는 스핀 박스의 경우 "11cm" 및 "1in"은 Acceptable, "11"과 빈 문자열은 Intermediate, "http://example.com" 및 "hour"는 Invalid 입니다.

fixup()는 일부 사용자 오류를 복구할 수 있는 유효성 검사기에 제공됩니다. 기본 구현은 아무 작업도 수행하지 않습니다. QLineEdit 예를 들어, 사용자가 Enter(또는 Return)를 누르고 콘텐츠가 현재 유효하지 않은 경우 fixup()를 호출합니다. 이렇게 하면 fixup() 함수가 Invalid 문자열 Acceptable 을 만드는 마법을 부릴 수 있습니다.

유효성 검사기에는 setLocale()로 설정된 로캘이 있습니다. 일반적으로 현지화된 데이터를 구문 분석하는 데 사용됩니다. 예를 들어 QIntValidator 및 QDoubleValidator 은 정수와 복수의 지역화된 표현을 구문 분석하는 데 사용합니다.

QValidator는 일반적으로 QLineEdit, QSpinBox 및 QComboBox 과 함께 사용됩니다.