第15.32节 PyQt(Python+Qt)入门学习：containers容器类部件QToolBox工具箱介绍及使用案例

• 老猿Python博文目录
• 专栏：使用PyQt开发图形界面Python应用
• 老猿Python博客地址

1、概述

容器部件就是能够在部件内放置其余部件的部件，在Qt Designer中可使用的容器部件有以下：

toolBox工具箱是一个容器部件，对应类为QToolBox，在其内有一列从上到下顺序排列的标签部件项（tabbed widget item），每一个标签部件项都有一个索引位置，位置索引是从上到下从0开始的顺序数字。每一个标签部件项同时对应一个QWidget或其派生的部件，当对应标签部件项被选中时，就在该每一个标签部件项下显示该每一个标签部件项对应的部件即标签部件。下图是同一个工具箱分别选中前三个不一样的标签部件项的截图：

能够看出，工具箱部件由多个标签项构成，每一个标签项包括一个标签和对应的部件，这些部件能够是任何QWidget或其派生的部件，只是部件的标题栏会被隐藏。工具箱的每一个标签就等他于真正的工具箱的手柄，鼠标点击后就会弹出对应的标签项。

2、toolBox的属性

在Designer中，toolBox主要有以下属性：

能够看到，toolBox的属性不多也很简单，主要包括以下属性：

• currentIndex：当前选择项的索引，从0开始计数，若是无标签部件项，则为-1，能够经过currentIndex()和setCurrentIndex(int index)方法进行属性的访问
• currentItemText：当前项的文本，该属性在QToolBox中并无，其实是使用的QToolBox的itemText属性，能够经过方法itemText(index)和setItemText(index, str text)来进行访问，只是index的值使用currentIndex便可
• currentItemName：当前项的名字，该属性在QToolBox中并无，其实是使用的QToolBox的QWidget（index）的objectName属性，能够经过方法QWidget（）的setObjectName（name）和objectName（）方法来访问
• currentItemIcon：当前项的图标，该属性在QToolBox中并无，其实是使用的QToolBox的itemIcon属性，能够经过方法itemIcon(int index)和setItemIcon(int index, QIcon icon)，只是index的值使用currentIndex便可
• currentItemToolTip：当前项的图标，该属性在QToolBox中并无，其实是使用的QToolBox的itemToolTip属性，能够经过方法itemToolTip(int index)和setItemToolTip(int index, str toolTip)，只是index的值使用currentIndex便可
• tabSpacing：每一个标签项之间的间距，该属性在QToolBox中并无，其实是使用的QToolBox的布局的spacing属性，该属性经过布局的spacing() 、setSpacing(int)来访问和设置。

3、标签部件项（tabbed widget item）相关方法

每一个标签部件项项都有一个项文本itemText（如“通信录”、“日历”等）、一个可选项图标（项文本左边的图标）、一个可选itemToolTip提示信息和一个标签部件。可使用setItemText（）、setItemIcon（）和setItemToolTip（）更改项的这些属性。可使用setItemEnabled（）单独启用或禁用每一个项。

使用addItem（）添加项，或使用insertItem（）在特定位置插入项。项目总数由count（）给定。可使用removeItem（）从工具箱中删除项。
当前项的索引由currentIndex（）返回，可以使用setCurrentIndex（）更改当前项。可使用indexof（）带部件对象做为参数找到该部件项对应的项的索引，也能够经过索引做为参数使用widget（）方法获取标签部件项返回。

4、toolBox编程使用的步骤

使用toolBox开发应用时，经过Designer设计ui界面时，只能在Designer中设计toolBox放置的位置以及增长标签（包括设定项名称、标签的文本、图标和工具提示信息）以及指定当前项，但没法指定标签部件项对应的部件。所以若是要结合Designer来进行工具箱的应用开发，能够借鉴以下步骤：

1. 设计UI界面，并放置toolBox；
2. 在ui中鼠标右键选中toolBox，经过“insert page”添加项，并指定项的项名称、标签的文本、图标和工具提示信息。固然若是嫌麻烦或者须要动态生成标签部件项也能够跳过本步骤；
3. 为标签部件项指定对应部件
   本步骤只能经过代码实现，若是步骤2未执行，则直接使用insertItem和addItem方法进行项的增长，不然须要先使用removeItem（）删除对应项再使用insertItem和addItem方法进行项的增长，因此步骤2其实执行后更麻烦，惟一的好处是能预览界面的状况，且标签的文本、图标和tooltip直接获取原来标签的便可无需在代码中指定。

注意：

在调用insertItem和addItem方法时，其QWidget参数为标签部件项下面要显示的部件实例，如上面截图三个项分别是一个自定义窗口、一个QCalendarWidget日历部件、一个QLCDNumber电子显示屏部件，直接用这些对象实例做为参数传递给insertItem和addItem方法。

例如设定电子显示屏显示当前时间的示例代码以下：

clock = QtWidgets.QLCDNumber()
    time = QtCore.QTime().currentTime()
    clock.display(time.toString("hh:mm"))
    icon = QtGui.QIcon(r"c:\temp\icon2.gif")
    self.toolBox.addItem(clock, icon, '时钟')

5、案例：利用QToolBox开发的桌面工具箱

5.一、引言

本部分将介绍老猿使用QToolBox实现的一个测试用Demo，实现一个桌面工具箱，在桌面工具箱中提供了通信录、日历、时钟、记事本、图片显示五个工具。

5.二、UI设计

下图为该工具箱的UI设计：

包含了上面所介绍的五个标签，在UI界面就设计标签部件项，其实在转换成代码后更麻烦，惟一的好处是能预览界面的状况，且标签的文本、图标和tooltip直接获取原来标签的便可无需在代码中指定，但本Demo仍是基于在UI中设计好标签部件项便于演示，但后续代码实现稍微复杂。

另外还有一个通信录展现的窗口：

5.三、使用PyUIC生成UI对应代码文件

生成ui_toolBoxTest.py为应用主界面、ui_showPersons.py为通信录展现窗口。

5.四、派生通信录管理类personListWin

class personListWin(QtWidgets.QWidget,ui_showPersons.Ui_personListWin):
    def __init__(self,memberList=None):
        super().__init__()
        self.setupUi(self)
        if memberList:self.addMembers(memberList)

    def addMembers(self,memberList):
        self.itemList.addItems(memberList)

之因此派生该类是为了实例建立时能够直接添加成员。

5.五、定义数字时钟类DigitalClock

数字时钟从QtWidgets.QLCDNumber派生，实时显示时间：

class DigitalClock(QtWidgets.QLCDNumber):
    def __init__(self):
        super().__init__()
        self.setDigitCount(8) #显示8个字符
        self.timer =   QtCore.QTimer(self)
        self.timer.timeout.connect( self.showTime) #链接每秒触发一次的计时信号和showTime方法
        self.timer.start(1000)
        self.showTime()  #显示当前时间
        
 	def showTime(self):#在lcd界面上显示时间
        ......

5.六、从UI界面类派生主界面类

派生类中作了以下几件事情：
一、为每一个标签部件项构建对应功能部件widget；
二、将原来UI设计的标签部件项的text、icon、tooltip取出来后删除原项；
三、根据text、icon、tooltip、widget建立新项。

class mainWindow(QtWidgets.QWidget,ui_toolBoxTest.Ui_mainWin):
    def __init__(self):
        super().__init__()
        self.setupUi(self)
        self.initToolItemList() #初始化五个标签部件项

    def setItem(self,index,widget):
       
        ......
        self.toolBox.insertItem(index, widget, icon, itemText)
       
   
    def initToolItemList(self):
        #从最后一个项开始绑定对应widget对象
        count = self.toolBox.count()
        current = self.toolBox.currentIndex() #保存当前选择项

        for loop in range(count):
            index = count-loop-1

            if index == 0:
                item = personListWin(['陈佳妮', '许姮', '王二妮', '冯华','吕程', '李诞', '郑菱', '孙蒿', '杨枼', '朱酷安','吴勇', '李晖', '铎铎', '老聂', '老杨', '陈老师', '老余']) #建立通信录部件
            elif index == 1:
                item = QtWidgets.QCalendarWidget() #建立日历部件
            elif index == 2:
                item = DigitalClock() #建立数字时钟部件
            elif index == 3:
                item = QtWidgets.QTextEdit('8:30 晨会') #建立记事本部件
                item.append('9:30 项目方案讨论')
                item.append('14:30 督办跟踪')
                item.append('16:00 OA文及邮件处理')
            else:
                view = QtWidgets.QGraphicsScene()  #建立图片展现部件

                view.addPixmap(QtGui.QPixmap(r"F:\屏保图片\壁纸20141214215651.jpg"))
                view.addText("Hello, world!")
                item = QtWidgets. QGraphicsView( view)
            self.setItem(index,item) #将item绑定到标签部件项的部件

        self.toolBox.setCurrentIndex(current) #恢复当前选中项

5.七、运行界面截图

6、小结

一个工具箱由多个标签项和对应页面部件构成，标签项从上到下顺序排列，当前项的页面展现在当前标签项下面。本节介绍了toolBox工具箱的属性、方法和信号，最后经过一个案例介绍了完整的工具箱开发过程，有助于你们理解对工具箱应用的开发步骤。

广告

老猿关于PyQt的付费专栏《使用PyQt开发图形界面Python应用》只须要9.9元，该部分与第十五章的内容基本对应，但一样内容在付费专栏上整体来讲更详细、案例更多。本节内容对应付费专栏的《第二十六章、containers容器类部件QToolBox工具箱详解》。若是有兴趣也愿意支持老猿的读者，欢迎购买付费专栏。

老猿Python，跟老猿学Python!

• 老猿Python博文目录
• 专栏：使用PyQt开发图形界面Python应用
• 老猿Python博客地址