IntValidator QML Type

정수 값에 대한 유효성 검사기를 정의합니다. 더 보기...

• 상속된 멤버를 포함한 모든 멤버 목록

속성

• bottom : int
• locale : string
• top : int

상세 설명

IntValidator 유형은 정수 값에 대한 유효성 검사기를 제공합니다.

locale 가 설정되지 않은 경우, IntValidator는 숫자를 해석하기 위해 default locale 를 사용하며, 로케일별 숫자, 그룹 구분자, 양수 및 음수 기호를 허용합니다. 또한 IntValidator는 "C" 로케일에 따라 서식 지정된 숫자를 항상 허용합니다.

다음 예제는 사용자가 지정된 범위 내의 정수를 입력했는지 확인하고, 유효하지 않은 입력을 강조 표시하기 위해 텍스트 색상을 업데이트하는 IntValidator가 포함된 TextInput 객체를 보여줍니다:

import QtQuick

TextInput {
    focus: true
    validator: IntValidator {
        bottom: 0
        top: 100
    }
    color: acceptableInput ? "black" : "red";
}

이 유효성 검사기는 명백히 유효하지 않은 텍스트의 제출을 차단합니다. 그러나 편집 중에는 부호 충돌이나 0이 아닌 자릿수가 너무 많은 경우 등 쉽게 식별할 수 있는 무효한 입력만 차단됩니다. 이로 인해 때때로 예상치 못한 결과가 발생할 수 있습니다. 예를 들어, 위 예제의 유효성 검사기는 "999"와 같은 값의 입력을 허용합니다. 최대값 이하의 자릿수로 구성된 값은 "중간 상태"로 간주되기 때문입니다. 즉, 이 값들은 유효하지는 않지만 조정하면 유효해질 수 있는 상태입니다. 이는 숫자가 범위 내에 들어가지 못하게 하는 자릿수가 반드시 마지막에 입력된 자릿수일 필요는 없기 때문입니다. 또한 이는 '중간' 상태의 숫자에도 선행 0이 포함될 수 있음을 의미합니다.

TextInput 의 acceptableInput 속성을 기반으로 시각적 표시기를 추가하면, 사용자가 입력한 내용이 실제로 허용될지 여부를 명확히 알 수 있습니다.

DoubleValidator, RegularExpressionValidator 및 입력 텍스트 유효성 검사항목도 참조하십시오 .

속성 설명서

bottom : int

이 속성은 유효성 검사기가 허용하는 최소값을 저장합니다. 기본적으로 이 속성의 값은 사용 가능한 가장 작은 부호 있는 정수(일반적으로 -2147483647)에서 파생됩니다.

locale : string

이 속성은 숫자를 해석하는 데 사용되는 로케일의 이름을 저장합니다.

Qt.locale()도 참조하십시오 .

top : int

이 속성은 유효성 검사기가 허용하는 최대 값을 저장합니다. 기본적으로 이 속성의 값은 사용 가능한 최대 부호 있는 정수(일반적으로 2147483647)에서 파생됩니다.