DoubleValidator QML Type
정수가 아닌 숫자에 대한 유효성 검사기를 정의합니다. 더 보기...
| Import Statement: | import QtQuick |
| In C++: | QDoubleValidator |
속성
상세 설명
DoubleValidator 유형은 정수가 아닌 숫자에 대한 유효성 검사기를 제공합니다.
- 허용되는 입력: 유효한 범위 내에 있고 올바른 형식을 따르는 double 값을 포함하는 경우 입력이 허용됩니다.
- 허용되지만 유효하지 않은 입력: 유효한 범위 밖의 double 값을 포함하거나 형식이 잘못된(예: 소수점 이하 자릿수가 너무 많거나 공백인 경우) 경우, 입력은 허용되지만 유효하지 않은 것으로 간주됩니다.
- 거부된 입력: double이 아닌 입력은 거부됩니다.
참고: 유효 범위가 양의 double로만 구성되어있고 (예: 0.0~100.0), 입력이 음의 double인경우 , 해당 입력은 거부됩니다. notation 가 DoubleValidator.StandardNotation 로 설정되어 있고, 입력의 소수점 앞 자릿수가 유효 범위의 double이 가질 수 있는 자릿수보다 많은 경우에도 해당 입력은 거부됩니다. notation 가 DoubleValidator.ScientificNotation 로 설정되어 있고 입력값이 유효한 범위에 속하지 않는 경우, 해당 입력은 허용되지만 유효하지 않은 것으로 간주됩니다. 지수를 변경하면 해당 값이 유효해질 수 있습니다.
다음 예제는 사용자가 지정된 범위 내의 double 값을 입력했는지 확인하고, 유효하지 않은 입력 시 텍스트 색상을 변경하여 강조 표시하는 DoubleValidator를 사용하는 TextInput 객체를 보여줍니다:
import QtQuick
TextInput {
focus: true
validator: DoubleValidator {
bottom: 0.00
top: 100.00
decimals: 2
notation: DoubleValidator.StandardNotation
}
onAcceptableInputChanged:
color = acceptableInput ? "black" : "red";
}IntValidator, RegularExpressionValidator 및 입력 텍스트 유효성 검사항목도 참조하십시오 .
속성 설명서
bottom : real
이 속성은 유효성 검사기가 허용하는 최소 값을 저장합니다. 기본적으로 이 속성의 값은 -무한대입니다.
decimals : int
이 속성은 유효성 검사기의 소수점 이하 최대 자릿수를 지정합니다. 기본적으로 이 속성의 값은 1000입니다.
locale : string
이 속성은 숫자를 해석하는 데 사용되는 로캘의 이름을 저장합니다.
Qt.locale()도 참조하십시오 .
notation : enumeration
이 속성은 문자열이 숫자를 어떻게 표현할 수 있는지에 대한 표기법을 저장합니다.
이 속성의 가능한 값은 다음과 같습니다:
| 상수 | 설명 |
|---|---|
DoubleValidator.StandardNotation | 부호가 선택적으로 포함될 수 있는 십진수만 허용(예: -0.015) |
DoubleValidator.ScientificNotation | (기본값) 표기된 숫자에 지수 부분이 포함될 수 있습니다(예: 1.5E-2). |
top : real
이 속성은 유효성 검사기가 허용하는 최대 값을 저장합니다. 기본적으로 이 속성의 값은 무한대입니다.
© 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.