QValidator Class

상세 설명

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

내장된 유효성 검사기만으로는 충분하지 않은 경우, QValidator를 상속하여 하위 클래스를 만들 수 있습니다. 이 클래스에는 validate()와 fixup()라는 두 개의 가상 함수가 있습니다.

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

이 세 가지 상태에 대해 설명이 필요합니다. ‘ Invalid ’ 문자열은 명백히 유효하지 않습니다. ‘ Intermediate ’은 다소 모호합니다. 문자열이 불완전할 때(아직 편집 중인 경우) 유효성 개념을 적용하기 어렵기 때문입니다. QValidator는 ‘ Intermediate ’을 명백히 유효하지도 않고 최종 결과로도 받아들일 수 없는 문자열의 속성으로 정의합니다. ‘ Acceptable ’은 해당 문자열이 최종 결과로 받아들여질 수 있음을 의미합니다. Acceptable 문자열을 입력하는 과정에서 타당한 중간 상태인 모든 문자열은 Intermediate 라고 할 수 있습니다.

다음은 몇 가지 예시입니다:

• 10부터 1000까지(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 로 변환하는 등의 처리를 수행할 수 있습니다.

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

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