当前位置：首页 > news >正文

QLineEdit的提交前验证

news 来源：原创 2025/8/24 13:26:49

QLineEdit是pyqt中常用的输入控件，默认情况下，它可以接受键盘输入的任何可打印字符。有时候，我们需要在用户提交前对其输入的内容先行验证，当用户输入不符合预期时予以清空，这就需要对QLineEdit控件进行以下操作：

1、创建一个验证器实例，并将其绑定到QLineEdit控件上。示例代码片段如下：

# 创建一个 QIntValidator 实例，限制用户输入整数，设置范围为 1 到 30
validator = QIntValidator(1, 30, self)
# 将验证器设置到 QLineEdit 上
self.line_edit.setValidator(validator)

2、有必要时创建一个自定义验证函数，并将其连接到textChanged事件。示例代码片段如下：

# 连接 textChanged 信号到自定义的验证函数
self.line_edit.textChanged.connect(self.validate_input)

以下是一个完整示例，创建一个农历日期输入器，只能输入1到当月最大的农历日期。确定当月最大的农历日期时采用了lunarcalendar模块。考虑到农历每月只可能有30天和29天，我们先用30作为日期构建一个lunarcalendar.Lunar对象，如果发生了DateNotExist异常，则说明当月最大日期为29，否则为30。具体代码如下：

import sysfrom PyQt5.QtCore import Qt
from PyQt5.QtGui import QIntValidator
from PyQt5.QtWidgets import QDialog, QLineEdit, QVBoxLayout, QLabel, QHBoxLayout, QCheckBox, QPushButton, QApplication, \QGroupBox, QMessageBoxfrom lunarcalendar import Lunar, DateNotExistclass InputDayDlg(QDialog):def __init__(self, year, month):self.day = 0super().__init__()day_label = QLabel("农历日子:")self.line_edit = QLineEdit(self)# 创建复选框self.leap_checkbox = QCheckBox('闰月', self)day_layout = QHBoxLayout()day_layout.addWidget(day_label)day_layout.addWidget(self.line_edit)day_layout.addWidget(self.leap_checkbox)day_group = QGroupBox()self.isleap = self.leap_checkbox.isChecked()self.max_day = self.get_max_day(year, month, self.isleap)# 在文本框中显示提示文本self.line_edit.setPlaceholderText(f'请输入1 - {self.max_day}之间的数字')self.line_edit.setFixedWidth(188)# 创建一个 QIntValidator 实例，设置范围为 1 到 max_dayvalidator = QIntValidator(1, self.max_day, self)# 将验证器设置到 QLineEdit 上self.line_edit.setValidator(validator)# 连接 textChanged 信号到自定义的验证函数self.line_edit.textChanged.connect(self.validate_input)day_group.setLayout(day_layout)confirm_button = QPushButton("确定")confirm_button.clicked.connect(self.accept)# 创建一个垂直布局layout = QVBoxLayout()layout.addWidget(day_group)layout.addWidget(confirm_button, alignment=Qt.AlignCenter)# 设置布局self.setLayout(layout)def get_day(self):text = self.line_edit.text()while len(text) == 0 or text == '':QMessageBox.warning(self, '注意', f'请输入农历日子，范围为1~{self.max_day}。')self.exec()text = self.line_edit.text()self.day = int(self.line_edit.text())return self.daydef get_max_day(self, year, month, isleap):try:# 农历每月的最大日期只有29天和30天这两种情况，尝试创建30日的Lunar对象，Lunar(year, month, 30, isleap=isleap)# 如果没有抛出异常，说明30日存在，返回最大日期 30return 30except DateNotExist:# 抛出ValueError异常，说明30日不存在，此时返回29return 29def validate_input(self, text):"""限制文本框输入的数字在范围内"""state = self.line_edit.validator().validate(text, 0)[0]if state != QIntValidator.Acceptable:# 如果输入不合法，清空输入框self.line_edit.clear()if __name__ == '__main__':app = QApplication([])dialog = InputDayDlg(2025, 10)if dialog.exec() == QDialog.Accepted:print(dialog.get_day())sys.exit()

上面的代码运行后出现如下对话框：

将月份改成12月，即：

dialog = InputDayDlg(2025, 12)

因为今年没有大年三十，对话框变成：

试着在文本框中输入内容，会发现一旦输入超出范围的字符，文本框就会清空。

除了上面的QIntValidator验证器用于验证整数输入外，常用的验证器还有：

1、QDoubleValidator
用于验证浮点数输入，可设置最小值、最大值和小数位数。

2、QRegularExpressionValidator
用于使用正则表达式验证输入，可根据自定义的正则表达式规则验证输入内容。这个验证器可以充分发挥正则表达式的强大功能，能够满足绝大部分需求。

相关文章：