首页 PyQt5视频教程 PyQt5 QLineEdit单行文本输入框控件API大全和实例演示
pay pay

PyQt5 QLineEdit单行文本输入框控件API大全和实例演示

日期: 七月 1, 2023, 11:33 a.m.
栏目: PyQt5视频教程
阅读: 82
作者: Python自学网-村长

摘要: QLineEdit是一个常用的单行文本输入框控件,可以让用户输入或编辑单行文本信息。本文将介绍QLineEdit的API大全以及演示。

QLineEdit是一个常用的单行文本输入框控件,可以让用户输入或编辑单行文本信息。本文将介绍QLineEdit的API大全以及演示。

QLineEdit的常用API

1.构造函数

QLineEdit的构造函数有多种形式:

QLineEdit(parent: QWidget = None)
QLineEdit(str, parent: QWidget = None)
QLineEdit(str, QWidget)

第一种构造函数创建一个空的单行文本输入框,它的父对象是parent。第二种构造函数创建一个带有默认文本的单行文本输入框,它的父对象是parent。第三种构造函数创建一个带有默认文本的单行文本输入框,它的父对象是parent。

2.设置文本内容

void setText(self, str)

这个方法可以设置文本框的文本内容,例如:

lineEdit.setText("Hello World")

3.获取文本内容

str text(self) const

这个方法可以获取文本框的文本内容,例如:

text = lineEdit.text()

4.清空文本内容

void clear(self)

这个方法可以清空文本框的文本内容,例如:

lineEdit.clear()

5.设置最大长度

void setMaxLength(self, int)

这个方法可以设置文本框最大可输入的字符数,例如:

lineEdit.setMaxLength(10)

6.设置只读模式

void setReadOnly(self, bool)

这个方法可以设置文本框是否为只读模式,只读模式下用户无法编辑文本框内容,例如:

lineEdit.setReadOnly(True)

7.设置占位符

void setPlaceholderText(self, str)

这个方法可以设置文本框的占位符文本,例如:

lineEdit.setPlaceholderText("请输入内容")

8.设置输入掩码

void setInputMask(self, str)

这个方法可以设置文本框的输入掩码,用于限制用户输入的内容格式,例如:

lineEdit.setInputMask("000-0000-0000")

9.设置对齐方式

void setAlignment(self, Qt.AlignmentFlag)

这个方法可以设置文本框的对齐方式,例如:

lineEdit.setAlignment(Qt.AlignCenter)

10.设置回显模式

void setEchoMode(self, QLineEdit.EchoMode)

这个方法可以设置文本框的回显模式,例如:

lineEdit.setEchoMode(QLineEdit.Password)

常用的回显模式有:Normal(正常回显,即显示用户输入的字符)、NoEcho(不回显,即不显示用户输入的字符)、Password(密码回显,即用“*”代替用户输入的字符)、`PasswordEchoOnEdit(编辑时回显)

QLineEdit单行文本输入框控件还有一些其他的API方法和信号,下面介绍一下:

API方法:

  • void setMaxLength(int length): 设置输入框的最大字符长度为length,超过该长度将无法输入。
  • void setReadOnly(bool readOnly): 设置输入框是否只读。如果设置为true,则不能对输入框进行编辑。
  • void setEchoMode(QLineEdit::EchoMode mode): 设置输入框的回显模式。常见的回显模式有以下几种:
  • QLineEdit::Normal:默认模式,输入的字符会正常显示。
  • QLineEdit::NoEcho:输入的字符不会显示在输入框中,常用于密码输入等场景。
  • QLineEdit::Password:输入的字符会被替换成固定的字符,比如星号或者圆点,用于密码输入场景。
  • QLineEdit::PasswordEchoOnEdit:与Password模式类似,但在输入时会显示原本的字符,编辑完成后再将字符替换成固定字符。
  • void setTextMargins(int left, int top, int right, int bottom): 设置输入框的文字边距。left、top、right、bottom参数分别表示左、上、右、下边距的像素值。
  • void setPlaceholderText(const QString &text): 设置输入框的占位符文本,即在输入框中没有输入内容时显示的提示文本。
  • void setValidator(const QValidator *validator): 设置输入框的验证器,用于限制输入框中输入的字符。常见的验证器有QIntValidator、QDoubleValidator、QRegExpValidator等。

信号:

  • void textChanged(const QString &text): 输入框中的文本内容发生变化时触发该信号。text为输入框中的新文本内容。
  • void textEdited(const QString &text): 用户编辑输入框中的文本时触发该信号,与textChanged信号不同,该信号只在用户编辑输入框时触发,而不是在程序通过setText()等方法修改文本时触发。
  • void returnPressed(): 用户在输入框中按下回车键时触发该信号。
  • void selectionChanged(): 当输入框中的文本选择发生变化时触发该信号。
  • void editingFinished(): 当输入框完成编辑时触发该信号,比如输入框失去焦点时。
原创视频,版权所有,未经允许,切勿转载,违者必究!
回顶部