pyqt4文档阅读(10.1):QIntValidator-QDoubleValidator-QRegExpValidator

本系列文章长期更新修改.

QIntValidator,QDoubleValidator,QRegExpValidator,都是继承QValidator的验证器.

QIntValidator和QDoubleValidator分别是整数和浮点数的验证器,而QRegExpValidator则是正则表达式验证器,几乎可实现任何格式的输入验证.

属性:

QIntValidator

Methods

• __init__ (self, QObject parent)
• __init__ (self, int bottom, int top, QObject parent)
• int bottom (self)
• setBottom (self, int)
• setRange (self, int bottom, int top)
• setTop (self, int)
• int top (self)
• (QValidator.State, int) validate (self, QString, int)

QDoubleValidator

Types

• enum Notation { StandardNotation, ScientificNotation }

Methods

• __init__ (self, QObject parent)
• __init__ (self, float bottom, float top, int decimals, QObject parent)
• float bottom (self)
• int decimals (self)
• Notation notation (self)
• setBottom (self, float)
• setDecimals (self, int)
• setNotation (self, Notation)
• setRange (self, float bottom, float top, int decimals = 0)
• setTop (self, float)
• float top (self)
• (QValidator.State, int) validate (self, QString, int)

QRegExpValidator

Methods

• __init__ (self, QObject parent)
• __init__ (self, QRegExp rx, QObject parent)
• QRegExp regExp (self)
• setRegExp (self, QRegExp rx)
• (QValidator.State, int pos) validate (self, QString input, int pos)

详细分析:

1.validate()函数

三种验证器都有一个函数签名一样的validate()函数,该函数的分析参考QValidator篇.

• (QValidator.State, int pos) validate (self, QString input, int pos)

2.基础验证属性

三种验证器有用于验证的基础属性.

其中QIntValidator和QDoubleValidator类似,都有一个上界和下界(闭区间),输入要在上下界之间.但QDoubleValidator多了个小数点位数decimals.

QDoubleValidator在逻辑上使用定点数作为输入.假如小数点位数设置为2,而你输入2.333,QDoubleValidator不会接受这个输入.

而QRegExpValidator则有一个正则表达式,输入要匹配这个表达式.

这些属性都可以在初始化的时候设置,或者之后用get/set函数.

1. QIntValidator
   • __init__ (self, QObject parent)
   • __init__ (self, int bottom, int top, QObject parent)
     
   • int bottom (self)
   • setBottom (self, int)
     
   • int top (self)
     
   • setTop (self, int)
     
   • setRange (self, int bottom, int top)
     
2. QDoubleValidator
   • __init__ (self, QObject parent)
   • __init__ (self, float bottom, float top, int decimals, QObject parent)
     
   • float bottom (self)
     
   • setBottom (self, float)
     
   • float top (self)
     
   • setTop (self, float)
     
   • setRange (self, float bottom, float top, int decimals = 0)
     
   • int decimals (self)
     
   • setDecimals (self, int)
3. QRegExpValidator
   • __init__ (self, QObject parent)
   • __init__ (self, QRegExp rx, QObject parent)
     
   • QRegExp regExp (self)
   • setRegExp (self, QRegExp rx)

3.QDoubleValidator的符号类型notation

QDoubleValidator有一个属性notation,会影响validate()函数的结果.

枚举量	值	含义
QDoubleValidator.StandardNotation	0	标准浮点数(如0.015)
QDoubleValidator.ScientificNotation	1	科学计数法(如1.5e-2)

notation是一个枚举量,默认是QDoubleValidator.ScientificNotation

• Notation notation (self)
• setNotation (self, Notation)
  

当notation是标准型的时候,QDoubleValidator只接受0.015这样的输入,不接受1.5e-2.

而当它是科学计数法的时候,QDoubleValidator无论是0.015或1.5e-2都接受,这里要注意.

4.Intermediate和Invalid

不同验证器对QValidator的两个枚举量Intermediate和Invalid的理解是不同的.

对QIntValidator来说,如果数位太少,则返回Intermediate,数位太多或数字太大则返回Invalid.

比如,range是[100,499],输入50返回Intermediate,输入500返回Invalid.

对QDoubleValidator来说,range要考虑,小数点位数也要考虑.

在允许输入科学计数法的时候,当一个输入的小数点位数超出decimals属性时,如果这个数是标准型,则QDoubleValidator返回Invalid,如果是科学计数法的,则返回Intermediate.

对QRegExpValidator来说,如果输入再补充一些字符就能匹配的话,返回Intermediate,否则返回Invalid.