PyQt开发中,时常需要对控件的值进行校验,如需要校验QCheckBox是否被选中,QLabel是否校验值是否为空等等。在复杂的业务场景下,这类控件如果数量很多,逐个校验就显得麻烦,需要一一获得控件名称,再调用对应的方法来判断是否被选中、是否为空等。而且开发过程中如果多控件做了增减,还需要增减校验的逻辑,那会要了老命。

此篇文章,推荐使用__dict__属性 + 字典映射来快速校验控件值,并且无视后面控件的增减,无需调整代码。

__dict__是什么?

python开发的,或多或少都接触过该属性,它是独有的一个特性,用来保存的一些属性,关于这个属性的相关文章,网上一抓一大把,此处不作赘述,需要说明的是,类实例也有自己的__dict__属性,而且和__dict不同,“类实例dict只保存了通过self.xxx`所声明的属性和方法。

校验逻辑演示

接下来的演示中,仅使用QCheckBox(为了省事),同时要保持这些控件的名称要具备同样的特征,下面的截图中,所有的控件名称都以checkbox结尾。

1、使用.ui文件生成.py文件

2、简单写个入口程序

继承刚才生成的.py文件,在这里可以实现自己的方法,在自定义类中,先打印__dict__,看看有哪些值。

{  'centralwidget': ,   'gridLayout': ,   'c_checkbox': ,   'd_checkbox': ,   'a_checkbox': ,   'b_checkbox': ,   'f_checkbox': ,   'e_checkbox': ,   'menubar': ,   'statusbar': }

可以看到,它是一个字典,它包含了界面上所有的控件的名称和实例对象,这里就体现出了控件名称命名时遵守统一特征的好处了,即能望文生义,也方便处理。

3、提取所有QCheckBox的控件名称,构建一个校验的通用逻辑

import sysfrom PyQt6.QtWidgets import QMainWindow, QApplication, QCheckBoxfrom ui_main import Ui_MainWindowclass MainWindow(Ui_MainWindow, QMainWindow):    def __init__(self):        super().__init__()        super().setupUi(self)        self.show()        self.checkboxs()        def checkboxs(self):        # print(self.__dict__)        # 增加这个字典映射是为了可以自动处理更多类型的控件值校验        widget_mapping = {            'QCheckBox': QCheckBox.isChecked        }                # 获取所有QCheckBox的控件名称        boxs = [            item for item in self.__dict__ \                if item.endswith('_checkbox')        ]        # 用来保存未被勾选的控件        un_checked = []        for item in boxs:            widget_instance = self.__dict__.get(item)            widget_method = widget_mapping.get(                self.__dict__.get(item).__class__.__name__            )            # 如果该QCheckBox处于未选中,则被添加到列表中            if not widget_method(widget_instance):                un_checked.append(item)        print(un_checked)if __name__ == '__main__':    app = QApplication(sys.argv)    window = MainWindow()    sys.exit(app.exec())

4、逻辑分析

(1)
在代码

boxs = [            item for item in self.__dict__ \                if item.endswith('_checkbox')        ]

中,通过__dict__提取了所有以_checkbox结尾的控件名称,注意,这只是字符串而已,并非控件本身。

(2)构建一个通用的控件名称和控件方法的字典映射

# 增加这个字典映射是为了可以自动处理更多类型的控件值校验        widget_mapping = {            'QCheckBox': QCheckBox.isChecked        }

这么做的目的是为了让这个逻辑更具通用性,让这个逻辑兼容其他控件,简单来说,可以通过控件的名称(boxs列表)找到该控件对应的方法,因为每个控件获取值所用的方法不尽相同。

(3)遍历boxs列表,逐个去widget_mapping找对应的方法,假如这里要较多种控件的话,字典映射的优势就体现出来了。widget_method就是该控件获取值所要用的方法了,QCheckBox控件,就用isChecked方法来获取控件是否被选中。

(4)调用所找到的方法widget_method。这里之所以要把控件实例widget_instance传入方法中,是因为控件方法isChecked是单独调用的,它默认要传入self参数即实例本身。

运行代码看看效果

可以看到6个选项均为选中,打印结果符合该事实。

qt desinger中默认勾选两个,再试试效果

有4个未选中,打印结果符合事实。

总结

上面的仅为演示代码,只是演示处理此类问题的逻辑,刚构建逻辑时会显得很绕,但是构建起来后就很好用了,如果再渐增控件,只要遵守控件名称命名规范,那么所增加的控件校验也无需增加校验代码,减少控件也一样。

延申用法

如果一个界面中有很多控件需要填写数值或清空数值,如:

  • 提交表单后,控件数值初始化
  • 校验不通过,需要在控件中做信息提示(诸如placeholder)

一样可以使用这个逻辑进行处理,只要前期构建好,代码复用完全不是问题。