QValidator Class

詳細説明

このクラス自体は抽象です。ふたつのサブクラスQIntValidator およびQDoubleValidator は基本的な数値範囲のチェックを行い、QRegularExpressionValidator は独自の正規表現を使用した一般的なチェックを行います。

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

validate() はすべてのサブクラスで実装する必要があります。この関数は、引数が有効かどうかによって、Invalid 、Intermediate 、Acceptable のいずれかを返します（サブクラスのvalidの定義に対応）。

これら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 とともに使用されます。