QLineEdit是使用频率最高的控件之一,当我们想获取用户输入时自然而然得会用到它。
通常我们会将QLineEdit的信号或其他控件的信号绑定至槽函数,然后获取并处理编辑器内的数据。你会觉得我们拿到的是第一手的“热乎着”的数据,所以理所当然地将过滤和验证逻辑都加入槽函数中,然而事实并非如此。那么数据究竟通过了哪些流程最终才经由信号被我们获取呢?
或者你希望QLineEdit能拥有自动补全或是输入联想的功能,这又如何实现呢?
如果你对上面的问题毫无头绪,那么本文就是为你量身打造的,请继续往下阅读吧!
本文索引
引论
这一节将带你概览QLineEdit对数据的处理,并以一个示例引出后续章节的内容。你可以先在此处找到一些粗浅的回答,后续则会有详细的解释。
如果要简单的回答第一问,那么在我们获取到text内容前需要经过两个步骤:
它们分别由inputMask和QValidator实现,前者负责过滤用户的输入,后者则用于过滤后的信息的验证。
inputMask和validator的表现很相似,有时它们的功能还会有一些重合,那么它们是否能取代彼此呢?答案是否定的,看起来像鸭子的鸟有时候其实不是和鸭子没关系,后面我们仔细说明。
现在轮到回答第二个问题了。要实现补全和自动联想,你只需要将一个设置好的QCompleter对象传递给QLineEdit。是不是够简单?大部分时间也确实如此,然而“设置好的”这一形容词的很抽象的概念,所以有的时候你可能要失望了,不过别担心,后面我们也会详细介绍它的使用。
两问回答完毕,现在该来看看本文的示例了。这次我们将自己实现一个DateEdit(我知道有现成的QDateEdit,不过这里请允许我为了实践所学而造一个粗糙的轮子),并根据用户输入的日期计算当天是周几,效果如下:
实现CustomDateEdit在本节中我们将逐步实现CustomDateEdit,并详细介绍引论中提到的概念。
按照流程图的顺序,我们首先要讲解的便是输入数据的过滤——inputMask的功能。
过滤用户输入——inputMask在具体介绍一个能控制显示效果的特性前,我习惯于先描述其大致功能和具体的显示效果。
inputMask的功能:它是一串特定的规则,所有不符合规则的用户输入都会被丢弃,用户不管是从信号还是text槽都只能获取符合mask要求的输入数据,当然这个“用户”包括我们后面要介绍的QValidator及其派生类。
inputMask的显示效果:你只能输入合法的字符,输入非法字符是输入内容无法显示,光标停留在原处;如果你设置了mask的填充字符,则这些字符会显示在edit中,当输入合法字符时将覆盖它们,mask中的保留字符同样显示在edit中,但输入时会被跳过不可覆盖(类似占位符),引论中的效果图就是很好的例子。
inputMask就是一串由特殊字符组成的规则,通过规则给定的格式来控制文本的输入,具体的规则见下表:
特殊字符 对应规则A 必须输入的ascii字母,包括A-Z,a-z
a 和A一样,但是可选,也就是不输入这个字符也可以,占位符将保留
N 必须输入的ascii字母和数字,包括A-Z,a-z,0-9
n 和N一样,但是可选
X 必须输入的任意字符
x 和X一样,但是可选
9 必填的ascii的数字字符,包括0-9
0 和9一样,但是可选
D 必填的数字,包括1-9
d 和D一样,但可选
# 可选的数字或者加减号
H 必填的16进制的数字,包括A-F, a-f, 0-9
h 和H一样,但可选
B 必填的二进制数字,包括0和1
b 和B一样,但可选
> 所有在这个特殊字符之后的字符转换为大写
< 所有在这个特殊字符之后的字符转换为小写
! 关闭前面的大小写转换
[ ] { } 保留的特殊字符
\ 将特殊字符转义为普通字符
inputMask的格式为:([特殊字符]|[普通字符])*;占位符,分号后跟的是占位符,用于填充特殊字符留下的空位,默认为空格。下面看些例子:
000,000.00;_:用于输入一个最大6位,有两位小数的值,用_填充空位,edit会显示出类似___,___.__的效果
>AAAA-AAAA!-AAAA-AAAA:用于输入一个由连字符分割的字母数字组成的uuid或license key,且前八个字母会被转换为大写,在edit中显示为- - -
9999年09月09日:用于输入年月日的时间格式,可以输入2019年03月14日或2019年3月14日,显示效果在引论的效果图中。
空字符串:表示没有任何输入限制
你可以通过setInputMask设置mask,或inputMask获取当前的mask。
通过上面的说明和例子你应该已经学会了inputMask的使用,现在可以看看它与validator的区别了:
inputMask在用户进行输入时进行过滤,并且只存在符合规则和不符合两种状态,validator通常拥有第三种状态
inputMask只能过滤较为固定的格式,并且对于输入的最大长度产生限制,validator则要灵活的多