PyQt5学习笔记7 - QLineEdit

前文

PyQt5学习笔记2 - Designer和Pyuic5
PyQt5学习笔记3 - 布局管理
PyQt5学习笔记4 - QMainWindow
PyQt5学习笔记5 - QWidget
PyQt6学习笔记6 - QLabel

本文概述

QLineEdit, 限制输入，掩码输入

---

QLineEdit和QTextEdit

QLineEdit是一个单行文本框控件，仅可以输单行字符串。而QTextedit是一个多行文本框控件。

QlineEdit

方法	描述
setAlignment()	按固定值方式对齐文本: - Qt.AlignLeft, 水平方向靠左对齐 - Qt.AlignRight, 水平方向靠右对齐 - Qt.AlignCenter, 水平方向居中对齐 - Qt.AlignJustify, 水平方向调整间距两端对齐 - Qt.AlignTop, 垂直方向靠上对齐 - Qt.AlignBottom, 垂直方向靠下对齐 - Qt.AlignVCenter, 垂直方向居中对齐
clear()	清除文本框内容
setEchoMode()	设置文本框显示格式。允许输入的文本显示格式的值可以是: - QLineEdit.Normal, 正常显示所输入的字符，默认选项 - QLineEdit.NoEcho, 不显示任何输入的字符，常用语密码类型的输入，且其密码长度需要保密时 - QLineEdit.Password, 显示与平台相关的密码掩码字符，而不是实际输入字符 - QLineEdit.PasswordEchoOnEdit, 在编辑时显示字符，负责密码类型的输入
setPlaceholderText()	设置文本框浮显文字
setMaxLength()	设置文本框所允许输入的最大字符数
setReadOnly()	设置文本框为只读
setText()	设置文本内框内容
Text()	返回文本框内容
setDragEnabled()	设置文本框是否接受拖动
selectAll()	全选
setFocus()	获得焦点
setInputMask()	设置掩码
setValidator()	设置文本框的验证器(验证规则)，将限制任何可能输入的文本。可用的校验器为: - QIntValidator, 限制输入整数 - QDoubleValidator, 限制输入浮点数 - QRegexpValidator, 检查输入是否负责正则表达式

定义输入掩码的字符

字符	含义
A	ASCII字母字符是必须输入的(A~Z, a~z)
a	ASCII字母字符是允许输入的,但不是必须的
N	ASCII字母字符是必须输入的(A~Z, a~z, 0~9)
n	ASCII字母字符是允许输入的，但不是必须的
X	任何字符输入都是必须输入的
x	任何字符都是允许输入的，但不是必须的
9	ASCII数字字符是必须输入的(0~9)
0	ASCII数字字符是允许输入的，但不是必须的
D	ASCII数字字符是必须输入的(1~9)
d	ASCII数字字符是允许输入的，但不是必须的(1~9)
#	ASCII是数字字符或加减符号是允许输入的，但不是必须的
H	十六进制格式字符是必须输入的(A~F, a~f, 0~9)
h	十六进制格式字符是允许输入的，但不是必须的(A~F, a~f, 0~9)
B	二进制格式字符是必须输入的(0, 1)
b	二进制格式字符是允许输入的，但不是必须的(0, 1)
>	所有的字母都大写
<	所有的字母都小写
!	关闭大小写转换
\	使用""转义上面列出的字符

掩码由掩码字符和分隔字符组成，后面可以跟一个分号和空白字符，如下

掩码	注意事项
000.000.000.000;_	IP地址，空白字符是"_"
HH:HH:HH:HH:HH:HH;	MAC地址
0000-00-00	日期，空白字符是空格
>AAAAA-AAAAA-AAAAA-AAAAA-AAAAA;#	许可证号，空白字符是"-",所有的字母都转换为大写

文本框类常用的信号

信号	描述
selectionChanged	只要选择改变了，这个信号就会被发射
textChanged	当修改文本内容时，这个信号就会被发射
editingFinished	当编辑文本内容结束时，这个信号就会被发射

实例1：EchoMode的显示效果

from PyQt5.QtWidgets import QApplication, QLineEdit, QWidget, QFormLayout
import sys


class LineDemo(QWidget):
    def __init__(self, parent=None):
        super(LineDemo, self).__init__(parent)
        self.setWindowTitle('QLineEditDemo')

        form_layout = QFormLayout()
        normal_line = QLineEdit()
        no_echo_line = QLineEdit()
        password_line = QLineEdit()
        password_echo_line = QLineEdit()

        form_layout.addRow("Normal", normal_line)
        form_layout.addRow("NoEcho", no_echo_line)
        form_layout.addRow("Password", password_line)
        form_layout.addRow("PasswordEchoOnEdit", password_echo_line)

        normal_line.setPlaceholderText('Normal')
        no_echo_line.setPlaceholderText('NoEcho')
        password_line.setPlaceholderText('Password')
        password_echo_line.setPlaceholderText('PasswordEchoOnEdit')

        normal_line.setEchoMode(QLineEdit.Normal)
        no_echo_line.setEchoMode(QLineEdit.NoEcho)
        password_line.setEchoMode(QLineEdit.Password)
        password_echo_line.setEchoMode(QLineEdit.PasswordEchoOnEdit)

        self.setLayout(form_layout)


if __name__ == '__main__':
    app = QApplication(sys.argv)
    demo = LineDemo()
    demo.show()
    sys.exit(app.exec_())

"""
QLineEdit.PasswordEchoOnEdit: 在编辑的时候正常显示字符，输入完成焦点切换之后显示为密码字符形式，即使切回焦点也是密码形式。
"""

image.png

实例2: 验证器

import sys
from PyQt5.QtWidgets import QApplication, QLineEdit, QWidget, QFormLayout
from PyQt5.QtGui import QIntValidator, QDoubleValidator, QRegExpValidator
from PyQt5.QtCore import QRegExp


class LineEditDemo(QWidget):
    def __init__(self, parent=None):
        super(LineEditDemo, self).__init__(parent)
        self.setWindowTitle('LineEditDemo2')

        form_layout = QFormLayout()
        int_line = QLineEdit()
        double_line = QLineEdit()
        regexp_line = QLineEdit()

        form_layout.addRow('整型：', int_line)
        form_layout.addRow('浮点型：', double_line)
        form_layout.addRow('字母和数字：', regexp_line)

        int_line.setPlaceholderText('整型')
        double_line.setPlaceholderText('浮点型')
        regexp_line.setPlaceholderText('字母和数字')

        int_validator = QIntValidator(self)
        int_validator.setRange(1, 99)

        double_validator = QDoubleValidator(self)
        double_validator.setRange(-360, 360)
        double_validator.setNotation(QDoubleValidator.StandardNotation)
        double_validator.setDecimals(2)

        regexp = QRegExp('[a-zA-Z0-9]+$')
        regexp_validator = QRegExpValidator(self)
        regexp_validator.setRegExp(regexp)

        int_line.setValidator(int_validator)
        double_line.setValidator(double_validator)
        regexp_line.setValidator(regexp_validator)

        self.setLayout(form_layout)


if __name__ == '__main__':
    app = QApplication(sys.argv)
    main = LineEditDemo()
    main.show()
    sys.exit(app.exec())

image.png

实例3：输入掩码

"""
输入掩码
"""
import sys
from PyQt5.QtWidgets import QApplication, QLineEdit, QWidget, QFormLayout


class LineEditDemo(QWidget):
    def __init__(self, parent=None):
        super(LineEditDemo, self).__init__(parent)
        self.setWindowTitle('LineEditDemo')

        form_layout = QFormLayout()

        ip_line = QLineEdit()
        mac_line = QLineEdit()
        date_line = QLineEdit()
        license_line = QLineEdit()

        ip_line.setInputMask('000.000.000.000;_')
        mac_line.setInputMask('HH:HH:HH:HH:HH:HH;_')
        date_line.setInputMask('0000-00-00')
        license_line.setInputMask('>AAAAA-AAAAA-AAAAA-AAAAA-AAAAA;#')

        form_layout.addRow('数字掩码:', ip_line)
        form_layout.addRow('Mac掩码:', mac_line)
        form_layout.addRow('日期掩码:', date_line)
        form_layout.addRow('许可证掩码:', license_line)

        self.setLayout(form_layout)


if __name__ == '__main__':
    app = QApplication(sys.argv)
    demo = LineEditDemo()
    demo.show()
    sys.exit(app.exec())

image.png

实例4：综合示例

"""
综合示例
"""
import sys
from PyQt5.QtCore import Qt
from PyQt5.QtGui import QIntValidator, QDoubleValidator, QFont
from PyQt5.QtWidgets import QApplication, QLineEdit, QWidget, QFormLayout


class LineEditDemo(QWidget):
    def __init__(self, parent=None):
        super(LineEditDemo, self).__init__(parent)
        int_line = QLineEdit()
        self.setWindowTitle('LineEditDemo')

        double_line = QLineEdit()
        input_mask = QLineEdit()
        text_change = QLineEdit()
        password_line = QLineEdit()
        read_only_line = QLineEdit('Hello World!')

        int_line.setValidator(QIntValidator())
        int_line.setMaxLength(4)
        int_line.setAlignment(Qt.AlignRight)
        int_line.setFont(QFont('Arial', 20))

        double_line.setValidator(QDoubleValidator(0.99, 99.99, 2))

        input_mask.setInputMask('+99_9999_999999')

        text_change.textChanged.connect(self.text_changed)

        password_line.setEchoMode(QLineEdit.Password)
        password_line.editingFinished.connect(self.enter_press)

        read_only_line.setReadOnly(True)

        form_layout = QFormLayout()
        form_layout.addRow('整型限制', int_line)
        form_layout.addRow('浮点限制', double_line)
        form_layout.addRow('输入掩码', input_mask)
        form_layout.addRow('文本改变', text_change)
        form_layout.addRow('完成密码', password_line)
        form_layout.addRow('只读属性', read_only_line)

        self.setLayout(form_layout)

    @staticmethod
    def text_changed(text):
        print(f'输入的内容为{text}')

    @staticmethod
    def enter_press():
        print('已输入值')


if __name__ == '__main__':
    app = QApplication(sys.argv)
    demo = LineEditDemo()
    demo.show()
    sys.exit(app.exec_())

image.png

---

如有侵权，请联系删除