이 페이지에서

IntValidator QML Type

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

Import Statement: import QtQuick
In C++: QIntValidator

속성

상세 설명

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이 포함될 수 있음을 의미합니다.

TextInputacceptableInput 속성을 기반으로 시각적 표시기를 추가하면 사용자가 입력한 내용이 실제로 수락되는지 여부를 명확하게 알 수 있습니다.

DoubleValidator, RegularExpressionValidator입력 텍스트 유효성검사도 참조하세요 .

속성 문서

bottom : int

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

locale : string

이 속성은 숫자를 해석하는 데 사용되는 로캘의 이름을 보유합니다.

Qt.locale()도 참조하세요 .

top : int

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

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.