このページでは

IntValidator QML Type

整数値用のバリデータを定義します。詳細...

Import Statement: import QtQuick
In C++: QIntValidator

プロパティ

詳細な説明

IntValidator 型は整数値のバリデータを提供します。

locale が設定されていない場合、IntValidator はdefault locale を使用して数値を解釈し、 ロケール固有の数字やグループ区切り、正負の符号を受け付けるようになります。さらに、IntValidator は常に "C" ロケールに従ってフォーマットされた数値を受け付けることが保証されています。

次の例では、TextInput オブジェクトに IntValidator を指定し、ユーザが指定した範囲内の整数を入力したかどうかをチェックし、 テキストの色を更新して無効な入力を強調します:

import QtQuick

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

バリデータは有効である可能性のないテキストの投稿を防ぎます。しかし、編集中にブロックされるのは、符号の衝突やゼロ以外の桁が多すぎるなど、簡単に識別できる無効なものだけです。これは時に驚くべきことです。上の例のバリデータは、たとえば「999」の入力を許可します。最大値と同じかそれ以下の桁数で構成される値は「中間値」とみなされるからです。これは、数値の有効範囲を妨げる桁が、必ずしも入力された最後の桁であるとは限らないためである。これはまた、中間の数字が先行ゼロを持つ可能性があることを意味する。

TextInputacceptableInput プロパティに基づいた視覚的なインジケータを追加することで、ユーザーが入力したものが実際に受け入れられるかどうかを明確にすることができる。

DoubleValidatorRegularExpressionValidator入力テキストの検証も参照してください

プロパティ Documentation

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.