IntValidator QML Type

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

• 継承されたメンバーを含む、すべてのメンバーの一覧

プロパティ

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

詳細な説明

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」の入力は許可されます。これは、最大値以下の桁数からなる値は「中間状態」とみなされるためです。つまり、その値は現時点では無効ですが、調整すれば有効になる可能性がある状態にあるということです。 これは、数値が範囲内に入らない原因となる桁が、必ずしも最後に入力された桁とは限らないためです。また、これにより、中間状態の数値には先頭のゼロが含まれる可能性もあります。

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

DoubleValidator 、RegularExpressionValidator 、および「入力テキストの検証」も参照してください 。

プロパティのドキュメント

bottom : int

このプロパティには、バリデータが許容する最小値が格納されます。デフォルトでは、このプロパティの値は、利用可能な最小の符号付き整数（通常は -2147483647）から導出されます。

locale : string

このプロパティには、数値の解釈に使用されるロケールの名前が格納されます。

Qt.locale()も参照してください 。

top : int

このプロパティには、バリデータが許容する最大値が格納されます。デフォルトでは、このプロパティの値は、利用可能な最大符号付き整数（通常は 2147483647）から導出されます。