pyQt5 学习笔记（18）QLineEdit 单行文本输入

QLineEdit 控件是一个单行文本输入框，它继承自QWidget，是一个纯文本的输入框，接收键盘的输入，可显示为明文（如QQ登录框中的账号框）或者是密文（如QQ登录框中的密码框）。

创建单行文本框：

运行： 由于是单行文本框，所以无法换行，如果内容过多，则会滚动显示。构造函数也可以使创建文本框时，默认显示一行文字：

运行：

QLineEidt 显示文本可以用户主动输入，也可以由程序设置显示的内容。

其中，如果程序设置了密文显示，text()将获取到用户输入的真实值，而displayText()将获取到星号。 程序示例了insert(newText)的使用：

运行： 第12行：插入了字符“123”，该函数在光标处插入字符串 第13行：获取并打印了文本框的内容

注：使用 setText("") 或清空函数（详见后文）可以清楚文本框。

显示模式决定了输入框文本的显示情况，可以是明文，密文，或者是完全不显示等。

相关API：

其参数是一个枚举值

其中，NoEcho是安全性最高的，无论用户输入什么，都不显示，与密文Password相比，它连位数都是保密的。Unbuntu终端密码就是类似这种想过，初次使用很容易误以为程序不响应。

程序示例输出模式的设置和获取：

运行： 因为第1个输入框设置了PasswordEchoOnEdit，所以当光标离开以后，明文就变成了密文。

占位提示文本框时在文本框内显示提示文本，但是和显示文本不同，当获取焦点并输入文字以后，占位文本将被取消。 相关API

占位文本示例：

运行： 注意到，这里占位文本和普通文本是不同的，此处使用获取占用文本的函数才可以获取到占位文本。

单行文本可以通过函数设置清空文本按钮。

示例：

运行： 当按钮被按下时，文本会被清空，注意到，这里只有存在文本时，按钮才会被显示。

文本提前准备了两个图标素材：

添加操作行为可以在单行文本框内添加一个行为，即提供一个按钮，通常这个按钮用来设置文本的显示形式，添加行为使用addAction()方法：

运行： 这个action也可以添加在文本框的尾部，但是必须指定位置，否则不会显示。

上文的Aciton只是图标，可通过其信号来triggered添加动作：

运行： 第14~20行：定义槽函数，当Action被点击时，该函数被触发。函数根据当前文本框的显示模式，切换图标和显示的模式。 第25行：该信号还有一个参数，表示按键是否被选中，所以也可以使用这个参数来判断，但是次数的Action默认是不能被选中的，所以需要设置按键可被选中状态，该参数才有意义。

自动补全指的是如果历史记录有过匹配的账号，将弹出提醒。可以运用于登录框中，用户经常需要输入自己的账号，如果曾经登录过，那么输入第一个字母时，就可以补全账号。程序也可以设置默认的候选对象。默认的候选词通过setCompleter()来设置。

示例：

运行后输入Y： 注意到，这里是大小写敏感的，用户可以通过鼠标点击和键盘方向按键来选择。

输入限制是通过程序来对输入的文本进行限制，如只读，长度，内容类型等。

示例：

运行： 由于设置了只读，它看起来就像一个标签（Label），由于我们还设置了最大长度为5，所以程序设置了“Read Only”但是只显示了“Read ”

可以通过设置验证器（QValidator）来验证文本是否合法，通常，一些网站要求密码有一定的格式，如长度不能过短，需要特殊符号等 。QValidator是一个虚拟的类，不能被直接实例化，需用用户自定义子类方可使用。 以下程序示例了一个验证器的使用，但是它并不是真实的验证器，因为它并没有校验规则：

运行： 当程序输入文本以后，每一次文本的改变，都会触发一次validate()函数，该函数打印了文本和光标所在的位置。validate()返回3个值，第1个为验证的状态，第2个为文本的值，第3个为光标所在位置。它传入了2个参数，分别为输入的文本和光标的位置。 注意到，返回的文本这里直接返回输入的文本，如果你对这参数做了修改，QLineEidt的文本也将随着修改，返回的光标位置同样有影响。

验证器（validate()函数）返回值有3种状态：

需要Intermediate中间状态的原因数，有时候无法确定输入的字符是否是有效的，比如我们想要用户输入18-180的值，当用户第一个字符输入“9”时，但是光标位离开编辑框，此时validate()函数就需要返回这值。 fixup()是修复函数，是文本输入完毕后调用的函数，此时程序可以最后判断值是否合理，如果不合理，是显示空字符串（清空）或者是默认设置一个值。注意到：validate()是当文本变化一次，就调用一次，而fixup()是文本输入结束（比如焦点切换到其他输入框中）且本文不符合要求，才调用。

接下来我们对程序进一步补充， 让校验器能对数据进行判断，规定用户只能输入：18-180 的数值

以下程序使能了第一个文本框内文字的拖拽功能：

运行： QLineEdit默认是不能拖拽的，所以程序只使能第一个文本框的情况下，只有第一个文本框可以拖拽文字。

如果使用按钮来编辑文本框，需要注意一种情况：当用户点击按钮的时候，文本框会失去光标。比如，当你设置按钮的功能为[删除选中文字]时候，由于点击按钮时候，会失去焦点，此时文本框会取消选择的文字，接着按钮去删除文字，就会出现非预期的效果。

textEdited( text) 和 textChanged(text) 不同点是，前者强调了用户编辑，只要文本框被用户编辑，就会发射信号，而后者无论是程序改变还是用户编辑，只要文本发送改变，就会发射信号。 当编辑框失去焦点时，就认为结束的编辑，此时会发射editingFinished()信号。

运行： 以上测试程序可以观察部分信号的运行情况。