QValidator Class

詳細な説明

このクラス自体は抽象クラスです。2つのサブクラス、QIntValidator およびQDoubleValidator は、基本的な数値範囲のチェック機能を提供し、QRegularExpressionValidator は、カスタム正規表現を使用した一般的なチェック機能を提供します。

組み込みのバリデータでは不十分な場合は、QValidator をサブクラス化することができます。このクラスには、validate() およびfixup() という 2 つの仮想関数があります。

validate()はすべてのサブクラスで実装する必要があります。この関数は、引数が有効かどうか（サブクラスで定義された「有効」の基準に基づいて）に応じて、Invalid 、Intermediate 、またはAcceptable を返します。

これら3つの状態については、若干の説明が必要です。「Invalid 」の文字列は明らかに無効です。「Intermediate 」はそれほど明白ではありません。文字列が不完全（まだ編集中）である場合、有効性の概念を適用するのは困難だからです。「QValidator」は、「Intermediate 」を、明らかに無効でもなく、最終結果として受け入れ可能でもない文字列の性質として定義しています。「Acceptable 」は、その文字列が最終結果として受け入れ可能であることを意味します。Acceptable 文字列の入力中に、妥当な中間状態であるあらゆる文字列は、Intermediate であると言えるでしょう。

以下にいくつかの例を示します。

• 10から1000までの整数（両端を含む）を受け付けるラインエディットの場合、42および123はAcceptable 、空文字列、5、または1234はIntermediate 、そして「asdf」および10114はInvalid となります。
• URLを受け付ける編集可能なコンボボックスの場合、形式が正しいURLはすべてAcceptable となります。「http://example.com/」はIntermediate となります（これは、コピー＆ペーストの際に誤って末尾にコンマが入ってしまった可能性もあります）。 空の文字列はIntermediate （ユーザーが新しいURLを入力する準備として、テキストをすべて選択して削除した可能性がある）であり、「http:///./」はInvalid となります。
• 長さを指定できるスピンボックスの場合、「11cm」と「1in」はAcceptable となり、「11」と空文字列はIntermediate となり、「http://example.com」と「hour」はInvalid となります。

fixup()は、ユーザーによる入力ミスの一部を修正できるバリデータ向けに提供されています。デフォルトの実装では何も行われません。例えば、QLineEdit は、ユーザーがEnter（またはReturn）キーを押した際に、入力内容が現在有効でない場合、fixup()を呼び出します。これにより、fixup()関数は、Invalid という文字列をAcceptable に変換するような処理を行う機会を得ることができます。

バリデータにはロケールがあり、setLocale() で設定されます。これは通常、ローカライズされたデータを解析するために使用されます。例えば、QIntValidator やQDoubleValidator は、整数や倍精度浮動小数点のローカライズされた表現を解析するためにこれを使用します。

QValidatorは通常、QLineEdit 、QSpinBox 、およびQComboBox と組み合わせて使用されます。