Python语言编程系列010----PyQt中自定义导航条控件的方法

背景

PyQt是Qt界面库在Python下的绑定库，为在Python语言下编写GUI界面程序提供了极大的便利，关于自定义控件的方法例子，在网上大多能找到的是c++语言下Qt的例子，而直接使用PyQt实现的资料很少，这儿给出一个在Python语言中使用PyQt库自定义导航控件的例子。

自定义导航条控件例子说明

先看一下代码实现后的导航条控件运行的界面样子，如下图所示：

 

  

上图中，左侧是自定义的导航条控件，右侧是一个Label控件，显示了导航栏中当前选中的项的情况。该导航栏控件具有如下特点：

l 可以方便增加、删除选项

l 选中项和非选中项有明确的区别，如背景颜色、文字颜色，选中的指示条指示等，并能进行单独设置

l 鼠标移动时，通过颜色可区分当前鼠标所在位置对应的选项

l 当鼠标单击选中某个选项时，能发送信号，信号中包含了当前选项对应的索引、文字等内容

代码实现过程

根据上面的特点，在PyQt中实现了一个基于QWidget的导航条类——NavigationWidget，下面逐步说明主要的代码实现方法。

1、类的初始化

这部分主要实现导航条属性的一些初始设置，如整体/项的背景色、选中/非选中文字颜色、选中时指示条颜色、当前索引值、所有项等。主要代码如下图所示：

 

  

2、选项的增加、删除及其它属性的等操作

在类的初始化中，所有的选项放在了列表self.listItems中，所以对于导航条选项的增加删除等操作，本质上是在Python中实现列表元素的增加、删除等，这儿比较简单，如对于增加选项函数，定义了addItem函数。对于其它属性的操作，就是对类初始化中各种属性变量的赋值而已。

3、重定义鼠标移动、单击及离开等事件

在鼠标移动事件中根据当前鼠标的位置判断是否调用update()函数刷新当前选项的背景及文字颜色等；在鼠标单击事件中，如果当前选中的选项有变化，则发送一个当前选项已经改变了的信号(currentItemChanged)，信号中包含了当前选项的索引及对应的选项文字；鼠标离开事件中重置当前索引为-1并刷新背景。主要代码如下图所示：

 

  

4、重定义paintEvent事件

这是导航条控件中代码主要实现的地方，定义了控件在不同情况下的外观，主要实现了整体背景色的绘制、子项背景色及文字的绘制等工作，主要代码如下图所示：

 

  

自定义导航条控件测试例子

调用上面的导航条控件类，将其放到主窗口中，即可看到本文开头的运行界面。主窗口类的实现代码如下图所示：

 

  

备注

在这个例子的基础上可进一步扩展，如在每个选项上增加图标指示等，可实现功能更为丰富的导航条控件。

 

欢迎加关注，共同交流。