# QValidator Class Reference ## [[QtGui](index.htm) module] 該QValidator類提供了輸入文本的驗證。[More...](#details) 繼承[QObject](qobject.html)。 通過繼承[QDoubleValidator](qdoublevalidator.html)，[QIntValidator](qintvalidator.html)和[QRegExpValidator](qregexpvalidator.html)。 ### Types * `enum State { Invalid, Intermediate, Acceptable }` ### Methods * `__init__ (self, QObject?parent?=?None)` * `QString?input fixup (self, QString?input)` * `fixup (self, QString)` * `QLocale locale (self)` * `setLocale (self, QLocale?locale)` * `(State, QString, int) validate (self, QString, int)` * `(State, int) validate (self, QString, int)` * * * ## Detailed Description 該QValidator類提供了輸入文本的驗證。 類本身是抽象的。兩個子類，[QIntValidator](qintvalidator.html)和[QDoubleValidator](qdoublevalidator.html)，提供基本的數值范圍檢查，并[QRegExpValidator](qregexpvalidator.html)使用自定義的正則表達式提供了一般的檢查。 如果內置的驗證是不夠的，你可以繼承QValidator 。這個類有兩個虛函數：[validate](qvalidator.html#validate)（）和[fixup](qvalidator.html#fixup)（ ） 。 [validate](qvalidator.html#validate)（ ）必須由每個子類實現。它返回[Invalid](qvalidator.html#State-enum)，[Intermediate](qvalidator.html#State-enum) or [Acceptable](qvalidator.html#State-enum)根據其參數是否有效（有效的子類的定義） 。 這三種狀態需要一些解釋。一個[Invalid](qvalidator.html#State-enum)字符串是_clearly_無效。[Intermediate](qvalidator.html#State-enum)是不太明顯的：有效性的概念難以適用時該字符串是不完整的（仍在編輯） 。 QValidator定義[Intermediate](qvalidator.html#State-enum)作為一個字符串，既不是明顯無效，也不接受作為最終結果的財產。[Acceptable](qvalidator.html#State-enum)表示該字符串是可接受作為最終結果。有人可能會說，任何字符串，它是一個項目在一個合理的中間狀態[Acceptable](qvalidator.html#State-enum)字符串是[Intermediate](qvalidator.html#State-enum)。 下面是一些例子： * For a line edit that accepts integers from 10 to 1000 inclusive, 42 and 123 are [Acceptable](qvalidator.html#State-enum), the empty string and 5 are [Intermediate](qvalidator.html#State-enum), and "asdf" and 1114 is [Invalid](qvalidator.html#State-enum). * For an editable combobox that accepts URLs, any well-formed URL is [Acceptable](qvalidator.html#State-enum), "http://example.com/," is [Intermediate](qvalidator.html#State-enum) (it might be a cut and paste action that accidentally took in a comma at the end), the empty string is [Intermediate](qvalidator.html#State-enum) (the user might select and delete all of the text in preparation for entering a new URL) and "http:///./" is [Invalid](qvalidator.html#State-enum). * For a spin box that accepts lengths, "11cm" and "1in" are [Acceptable](qvalidator.html#State-enum), "11" and the empty string are [Intermediate](qvalidator.html#State-enum), and "http://example.com" and "hour" are [Invalid](qvalidator.html#State-enum). [fixup](qvalidator.html#fixup)（ ）用于驗證，可以修復一些用戶錯誤。默認實現不執行任何操作。[QLineEdit](qlineedit.html)例如，將調用[fixup](qvalidator.html#fixup)（ ）如果用戶按下Enter鍵（或Return ）和內容目前無效。這允許[fixup](qvalidator.html#fixup)（ ）函數執行一些魔法使的一個機會[Invalid](qvalidator.html#State-enum)串[Acceptable](qvalidator.html#State-enum)。 一個驗證器有一個區域，設置[setLocale](qvalidator.html#setLocale)（ ） 。它通常被用來解析本地化數據。例如，[QIntValidator](qintvalidator.html)和[QDoubleValidator](qdoublevalidator.html)用它來解析整數和雙精度的本地化表示。 QValidator通常用于[QLineEdit](qlineedit.html)，[QSpinBox](qspinbox.html)和[QComboBox](qcombobox.html)。 * * * ## Type Documentation ``` QValidator.State ``` 這個枚舉類型定義了一個驗證字符串可以存在的狀態。 | Constant | Value | Description | | --- | --- | --- | | `QValidator.Invalid` | `0` | 該字符串是_clearly_無效。 | | `QValidator.Intermediate` | `1` | 該字符串是一個合理的中間值。 | | `QValidator.Acceptable` | `2` | 該字符串是可以接受的最終結果，即它是有效的。 | * * * ## Method Documentation ``` QValidator.__init__ (self, QObject?parent?=?None) ``` 該_parent_的說法，如果不是沒有，原因_self_通過Qt的，而不是PyQt的擁有。 建立驗證程序。該_parent_參數被傳遞到[QObject](qobject.html)構造函數。 ``` QString?input QValidator.fixup (self, QString?input) ``` 這個函數試圖改變_input_根據該驗證器的規則是有效的。它必須不會導致一個有效的字符串：這個函數的調用者必須重新測試后，默認不做任何事情。 此函數的重新實現可以改變_input_即使他們不出示有效的字符串。例如， ISBN校驗器可能需要刪除每一個字符，除了數字和“ - ” ，即使結果仍然沒有有效的ISBN ，一個姓驗證器可能會想從字符串的開頭和結尾刪除空格，即使得到的字符串是不是在接受姓氏列表。 ``` QValidator.fixup (self, QString) ``` ``` QLocale QValidator.locale (self) ``` [ 返回locale的驗證。語言環境是默認初始化為相同的QLocale （ ） 。 ](qlocale.html) [**See also**](qlocale.html) [setLocale](qvalidator.html#setLocale)（）和[QLocale.QLocale](qlocale.html#QLocale)（ ） 。 ``` QValidator.setLocale (self, QLocale?locale) ``` 設置_locale_將要使用的驗證器。除非setLocale的被調用，驗證程序將使用默認的語言環境與集[QLocale.setDefault](qlocale.html#setDefault)（ ） 。如果默認語言環境尚未確定，它是操作系統的語言環境。 **See also** [locale](qvalidator.html#locale)（）和[QLocale.setDefault](qlocale.html#setDefault)（ ） 。 ``` (State, QString, int) QValidator.validate (self, QString, int) ``` 這種方法是抽象的，應在任何子類中重新實現。 這個虛函數返回[Invalid](qvalidator.html#State-enum)如果_input_是無效的，根據這個驗證的規則，[Intermediate](qvalidator.html#State-enum)如果它很可能是多一點的編輯將使得輸入可接受的（例如，在用戶鍵入“4”到它接受10? 99的整數窗口小部件） ，和[Acceptable](qvalidator.html#State-enum)如果輸入是有效的。 該功能可以同時改變_input_和_pos_（光標位置），如果需要的話。 ``` (State, int) QValidator.validate (self, QString, int) ``` 這種方法是抽象的，應在任何子類中重新實現。