QValidator 类

QValidator 类提供对输入文本的验证。更多...

头：	#include <QValidator>
CMake:	find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmake:	QT += gui
继承：	QObject
继承者：	QDoubleValidator , QIntValidator ，和 QRegularExpressionValidator

所有成员列表，包括继承成员

公共类型

enum	State { Invalid, Intermediate, Acceptable }

公共函数

	QValidator (QObject * parent = nullptr)
virtual	~QValidator ()
virtual void	fixup (QString & input ) const
QLocale	locale () const
void	setLocale (const QLocale & locale )
virtual QValidator::State	validate (QString & input , int & pos ) const = 0

信号

void	changed ()

详细描述

类本身是抽象的。2 个子类 QIntValidator and QDoubleValidator ，提供基本的数值范围校验，和 QRegularExpressionValidator 使用自定义正则表达式提供一般校验。

若内置验证器不够用，可以子类化 QValidator。类有 2 个虚函数： validate () 和 fixup ().

validate () 必须由每个子类来实现。它返回 Invalid , 中间体 or Acceptable 取决于其自变量是否有效 (对于有效的子类定义而言)。

这 3 种状态需要一些解释。 Invalid 字符串是 clearly 无效的。中间体不太明显：有效性概念难以应用，当字符串不完整 (仍在编辑) 时。QValidator 定义中间体作为字符串特性，作为最终结果这既不明显无效也不可接受。 Acceptable 意味着字符串可以作为最终结果被接受。有人可能会说，任何字符串都是合理中间状态，在输入期间 Acceptable 字符串是中间体 .

这里是一些范例：

对于接受 10 至 1000 (含 1000) 的整数的行编辑，42 和 123 是 Acceptable , the empty string, 5, or 1234 are 中间体 , and "asdf" and 10114 is Invalid .
对于接受 URL 的可编辑组合框，任何格式良好的 URL 是 Acceptable ，http://example.com/, 是中间体 (可能由于剪切和粘贴动作，意外在结尾加了个逗号)，空字符串是中间体 (用户可能选择并删除所有文本，预备键入新的 URL) 而 http:///./ 是 Invalid .
对于接受长度的自旋框，11cm 和 1in 是 Acceptable ，11 和空字符串是中间体，而 http://example.com 和 hour 是 Invalid .

fixup () 是为可以修理某些用户错误的验证器而提供的。默认实现什么都不做。 QLineEdit ，例如，会调用 fixup () 若用户按下 Enter 键 (或 Return 键) 且内容目前无效。这允许 fixup () 函数有机会履行一些魔法操作以使 Invalid string Acceptable .

验证器拥有区域设置，设置采用 setLocale ()。通常使用它来剖析本地化数据。例如， QIntValidator and QDoubleValidator 使用它来剖析整数和双精度数的本地化表示。

通常把 QValidator 用于 QLineEdit , QSpinBox and QComboBox .

另请参阅 QIntValidator , QDoubleValidator , QRegularExpressionValidator ，和行编辑范例 .

成员类型文档编制

enum QValidator:: State

此枚举类型定义可以存在经过验证的字符串状态。

常量	值	描述
`QValidator::Invalid`	`0`	字符串是 clearly 无效的。
`QValidator::Intermediate`	`1`	字符串是合理的中间体值。
`QValidator::Acceptable`	`2`	字符串是可接受的最终结果；即：它是有效的。

成员函数文档编制

`[explicit]` QValidator:: QValidator ( QObject * parent = nullptr)

设置验证器。 parent 参数被传递给 QObject 构造函数。

`[virtual noexcept]` QValidator:: ~QValidator ()

销毁验证器，释放使用的任何存储和其它资源。

`[signal]` void QValidator:: changed ()

此信号发射，当可能影响字符串有效性的任何特性改变时。

`[虚拟]` void QValidator:: fixup ( QString & input ) const

此函数试图改变 input 为有效根据此验证器的规则。它不需要产生有效字符串：此函数的调用者之后必须重新测试；默认什么都不做。

此函数的重实现可以改变 input 即使没有产生有效字符串。例如，ISBN 验证器可能想要删除除数字和 - 外的每个字符，即使结果仍是无效 ISBN；姓氏验证器可能想要从字符串开头和结尾移除空格，即使结果字符串不在接受姓氏列表中。

QLocale QValidator:: locale () const

返回用于验证器的区域设置。默认情况下，初始区域设置如同 QLocale()。

另请参阅 setLocale () 和 QLocale::QLocale ().

void QValidator:: setLocale (const QLocale & locale )

设置 locale 将用于验证器。除非已调用 setLocale，否则验证器将使用默认区域设置，设置采用 QLocale::setDefault ()。若默认区域设置尚未设置，则它是操作系统的区域设置。

另请参阅 locale () 和 QLocale::setDefault ().

`[pure virtual]` QValidator::State QValidator:: validate ( QString & input , int & pos ) const

此虚函数返回 Invalid if input 是无效的根据此验证器规则，中间体若可能的话，稍微多做一些编辑将使输入可接受 (如：用户在接受 10 至 99 的整数的 Widget 中键入 4)，及 Acceptable 若输入有效。

函数可以改变 input and pos (光标位置) 若有要求。