PyQt介绍——单行文本输入框QLineEdit

QLineEdit是单行文本输入框，允许用户输入和编辑单行纯文本

常用方法：

文本设置，获取和删除

方法	描述
setText(str)	设置内容文本
insert(newText)	在光标处插入文本
text()	获取真实内容文本(用户输入的内容)
displayText()	获取用户能看到的内容文本（密文显示时获取的是密文）
clear()	清除文本框内容
setEchoMode(QLineEdit.EchoMode)	设置文本框显示模式
setPlaceholderText()	设置文本框占位提示字符
placeholderText()	获取占位提示字符内容
setClearButtonEnabled(bool)	设置是否显示清空按钮
isClearButtonEnabled() -> bool	获取是否设置显示清空按钮
isModified()	获取文本框是否被编辑过(编辑之后光标离开，依然返回True)，这里获取的并不是文本框是否可以编辑，也不是获取是否正在编辑
setModified(bool)	设置文本框是否被编辑过

设置显示格式setEchoMode(QLineEdit.EchoMode)

属性说明
QLineEdit.NoEcho 不输出（不显示内容，实际是有内容）
QLineEdit.Normal 正常输出
QLineEdit.Password 密文输出
QLineEdit.PasswordEchoOnEdit 编辑时明文, 结束后密文

属性	说明
QLineEdit.NoEcho	不输出（不显示内容，实际是有内容）
QLineEdit.Normal	正常输出
QLineEdit.Password	密文输出
QLineEdit.PasswordEchoOnEdit	编辑时明文, 结束后密文

输入限制

方法	说明
setMaxLength(int)	设置限制输入的最大长度（字符个数，不是字节数）
maxLength()	获取设定的最大输入长度
setReadOnly(bool)	设置内容只读，可以选中复制，不能修改
isReadOnly()	获取是否设置只读
setValidator	设置验证器验证
setCompleter(QCompleter)	设置完成器（自动补全）
setInputMask(mask_str)	设置掩码验证
setDragEnabled()	设置文本框是否拖动

对齐方式setAlignment(Qt.Alignment)

alignment() ：获取文本内容对其方式，返回 Qt.Alignment 对象

方向	属性	描述
水平方向	Qt.AlignLeft	水平居左
	Qt.AlignRight	水平居右
	Qt.AlignHCenter	水平居中
	Qt.AlignJustify	水平方向调整间距两端对齐
垂直方向	Qt.AlignTop	垂直居上
	Qt.AlignBottom	垂直居下
	Qt.AlignVCenter	垂直居中
	Qt.AlignBaseline	与基线对齐
水平和垂直	Qt.AlignCenter	垂直和水平都居中，相当于Qt.AlignHCenter

文本边距设置
setTextMargins(int left，int top，int right，int bottom)：设置文本内容边距
getTextMargins() ：获取文本内容的边距,返回一个元组
常用编辑功能

backspace() # 删除选中文本(如果有) 或删除光标左侧一个字符
del_() # 删除选中文本(如果有) 或删除光标右侧的一个字符
clear() # 删除文本框所有内容
copy() # 复制
cut() # 剪切
paste() # 粘贴
isUndoAvailable() # 撤消是否可用
undo() # 撤消
isRedoAvailable() # 重做是否可用
redo() # 重做

setDragEnabled(bool) # 设置选中文本后是否可以拖拽

setSelection(start_pos, length) # 选中指定区间的文本
selectAll() # 选中所有文本
deselect() # 取消选中已选择文本
hasSelectedText() # 是否有选中文本
selectedText() -> str # 获取选中的文本
selectionStart() -> int # 选中的开始位置
selectionEnd() -> int # 选中的结束位置
selectionLength() -> int # 选中的长度

常用信号

信号	说明
textEdited(text)	文本编辑时发射的信号(通过代码设置文本内容时候不会触发该信号)
textChanged(text)	文本框文本发生改变时发出的信号
returnPressed()	按下回车键时发出的信号
editingFinished()	结束编辑时发出的信号(按下回车键、Tab键、丢失焦点时)
cursorPositionChanged(int oldPos，int newPos)	光标位置发生改变时发出的信号，传递原光标位置和新光标位置
selectionChanged()	选中的文本发生改变时发出的信号（光标开始移动时就会触发该信号，并不需要等到选中文本）

掩码字符

掩码字符	说明1	说明2
A	需要ASCII字母字符AZ，az	ASCII字母字符是必须输入的(A-Z、a-z)
a	允许但不要求使用ASCII字母字符	ASCII字母字符是允许输入的,但不是必需的(A-Z、a-z)
N	需要ASCII字母数字字符AZ，az，0-9	ASCII字母字符是必须输入的(A-Z、a-z、0-9)
n	允许但不要求使用ASCI字母数字字符	ASII字母字符是允许输入的,但不是必需的(A-Z、a-z、0-9)
X	需要任何角色	任何字符都是必须输入的
x	允许但不要求的任何角色	任何字符都是允许输入的,但不是必需的
9	需要ASCII数字0-9	ASCII数字字符是必须输入的(0-9)
0	允许使用ASCII数字但不是必需的	ASCII数字字符是允许输入的,但不是必需的(0-9)
D	需要ASCII数字1-9	ASCII数字字符是必须输入的(1-9)
d	允许但不需要ASCII数字 (1-9)	ASCII数字字符是允许输入的,但不是必需的(1-9)
#	允许但不要求ASCII数字或加号/减号	ASCI数字字符或加减符号是允许输入的,但不是必需的
H	需要十六进制字符AF，af，0-9	十六进制格式字符是必须输入的(A-F、a-f、0-9)
h	允许使用十六进制字符，但不是必需的	十六进制格式字符是允许输入的,但不是必需的(A-F、a-f、0-9)
B	需要二进制字符0-1	二进制格式字符是必须输入的(0,1)
b	允许二进制字符但不是必需的	二进制格式字符是允许输入的,但不是必需的(0,1)
>	以下所有字母字符均为大写字母	所有的字母字符都大写
<	以下所有字母字符均为小写字母	所有的字母字符都小写
!	关闭大小转换	关闭大小写转换
\	使用\逃脱上面列出的特殊字符使用它们作为分隔符	使用""转义上面列出的字符
[]{}	保留

例子：

# -*- coding: utf-8 -*-
from PyQt5.QtWidgets import QApplication, QLineEdit, QWidget, QFormLayout, QPushButton, QCompleter
from PyQt5.QtGui import QIntValidator, QDoubleValidator, QFont
from PyQt5.QtCore import Qt
import sys


class QlineEidtDemo1(QWidget):
    def __init__(self, parent=None):
        super(QlineEidtDemo1, self).__init__(parent)
        self.resize(500, 500)
        self.setWindowTitle("QLineEdit例子")

        form_lyt = QFormLayout()
        # 显示格式demo
        line1 = QLineEdit()
        line1.setMaxLength(3)  # 长度限制为3个字符
        line2 = QLineEdit()
        line3 = QLineEdit()
        line4 = QLineEdit()
        line4.setClearButtonEnabled(True)  # 设置开启清空按钮

        # 设置文本demo
        self.line_src = QLineEdit()
        self.line_dst = QLineEdit()
        self.line_dst.setReadOnly(True)  # 设置为只读
        btn = QPushButton('复制内容')
        btn.clicked.connect(self.copy_text)

        # 自动补全demo
        self.account_line = QLineEdit()
        # 创建QCompleter对象，用于自动补全参数
        completer = QCompleter(['Hello', 'Hi', 'BiuBiu', 'Biu', 'Aplle', 'abi'], self.account_line)
        self.account_line.setCompleter(completer)  # 设置自动补全

        # 输入限制
        le1 = QLineEdit(self)
        le2 = QLineEdit(self)
        le3 = QLineEdit(self)
        le4 = QLineEdit(self)
        le5 = QLineEdit(self)

        le1.setInputMask('9999-9999999;0')  # 座机号码：4位区号-7位电话，默认显示0
        le2.setInputMask('999.999.999.999;')  # IP地址：3位数字.3位数字.3位数字.3位数字，默认显示X
        le3.setInputMask('99999999999999999>N')  # 身份证号：17位数字+1位数字或大写字母
        le4.setInputMask('HH:HH:HH:HH:HH:HH;_')  # Mac地址：6组 十六进制字符，分隔符为:，默认显示_
        le5.setInputMask('>A!A_NNNNNN')  # 测试掩码：1位大写字母+1位大小写字母_6位大小写字母或者数字

        form_lyt.addRow("姓名: ", line1)
        form_lyt.addRow("年龄: ", line2)
        form_lyt.addRow("密码1: ", line3)
        form_lyt.addRow("密码2: ", line4)

        form_lyt.addRow(self.line_src, self.line_dst)
        form_lyt.addRow(btn)

        form_lyt.addRow("座机号码: ", le1)
        form_lyt.addRow("IP地址: ", le2)
        form_lyt.addRow("身份证号: ", le3)
        form_lyt.addRow("Mac地址: ", le4)
        form_lyt.addRow("掩码测试: ", le5)

        # 设置占位符文本
        line1.setPlaceholderText("输入姓名, 长度限制为3个字符")
        line2.setPlaceholderText("输入年龄，但是不会显示出来")
        line3.setPlaceholderText("输入密码")
        line4.setPlaceholderText("输入密码")

        self.line_src.setPlaceholderText("输入内容")  # 回车后密码显示
        self.line_dst.setPlaceholderText("点击复制内容按钮会同步到这里")  # 回车后密码显示

        # 设置显示效果
        line1.setEchoMode(QLineEdit.Normal)  # 正常显示
        line2.setEchoMode(QLineEdit.NoEcho)  # 不显示
        line3.setEchoMode(QLineEdit.Password)  # 密码显示
        line4.setEchoMode(QLineEdit.PasswordEchoOnEdit)  # 编辑时正常输出，失去光标时候显示密文

        self.setLayout(form_lyt)

    def copy_text(self):
        self.line_dst.setText(self.line_src.text())


if __name__ == "__main__":
    app = QApplication(sys.argv)
    win = QlineEidtDemo1()
    win.show()
    sys.exit(app.exec_())