pyqt下QTableWidget使用方法小结

QTableWidget是QT程序中常用的显示数据表格的空间，很类似于VC、C#中的DataGrid。说到QTableWidget，就必须讲一下它跟QTabelView的区别了。QTableWidget是QTableView的子类，主要的区别是QTableView可以使用自定义的数据模型来显示内容(也就是先要通过setModel来绑定数据源)，而QTableWidget则只能使用标准的数据模型，并且其单元格数据是QTableWidgetItem的对象来实现的(也就是不需要数据源，将逐个单元格内的信息填好即可)。这主要体现在QTableView类中有setModel成员函数，而到了QTableWidget类中，该成员函数变成了私有。使用QTableWidget就离不开QTableWidgetItem。QTableWidgetItem用来表示表格中的一个单元格，正个表格都需要用逐个单元格构建起来。

 

下面代码实现了一个最简单的含有QTableWidget的小程序：

 #!/usr/bin/env python
 #coding=utf-8
 from PyQt4.QtGui  import *
 from PyQt4.QtCore import *
 class MyDialog(QDialog):
     def __init__(self, parent=None):
         super(MyDialog, self).__init__(parent)
         self.MyTable = QTableWidget(4,3)
         self.MyTable.setHorizontalHeaderLabels(['姓名','身高','体重'])

         newItem = QTableWidgetItem("松鼠")
         self.MyTable.setItem(0, 0, newItem)

         newItem = QTableWidgetItem("10cm")
         self.MyTable.setItem(0, 1, newItem)

         newItem = QTableWidgetItem("60g")
         self.MyTable.setItem(0, 2, newItem)

         layout = QHBoxLayout()
         layout.addWidget(self.MyTable)
         self.setLayout(layout)


 if __name__ == '__main__':
     import sys
     app = QApplication(sys.argv)
     myWindow = MyDialog()
     myWindow.show()
     sys.exit(app.exec_())

 

其中：

self.MyTable = QTableWidget(4,3)  构造了一个QTableWidget的对象，并且设置为4行，3列

self.MyTable.setHorizontalHeaderLabels(['姓名','身高','体重']) 则设置表格的表头

newItem = QTableWidgetItem("松鼠")   则是生成了一个QTableWidgetItem的对象，并让其名为“松鼠”

self.MyTable.setItem(0, 0, newItem)    将刚才生成的Item加载到第0行、0列处

 

这样一个简单的QTableWidget就构造完成了。

 

第一部分：对QTableWidget本身的效果实现

1.将表格变为禁止编辑

在默认情况下，表格里的字符是可以更改的，比如双击一个单元格，就可以修改原来的内容，如果想禁止用户的这种操作，让这个表格对用户只读，可以这样：

self.MyTable.setEditTriggers(QAbstractItemView.NoEditTriggers)   #MyTable是上面代码中生成的QTableWidget对象

 

QAbstractItemView.NoEditTriggers是QAbstractItemView.EditTrigger枚举中的一个，都是触发修改单元格内容的条件：

QAbstractItemView.NoEditTriggers	0	No editing possible. 不能对表格内容进行修改
QAbstractItemView.CurrentChanged	1	Editing start whenever current item changes.任何时候都能对单元格修改
QAbstractItemView.DoubleClicked	2	Editing starts when an item is double clicked.双击单元格
QAbstractItemView.SelectedClicked	4	Editing starts when clicking on an already selected item.单击已选中的内容
QAbstractItemView.EditKeyPressed	8	Editing starts when the platform edit key has been pressed over an item.
QAbstractItemView.AnyKeyPressed	16	Editing starts when any key is pressed over an item.按下任意键就能修改
QAbstractItemView.AllEditTriggers	31	Editing starts for all above actions.以上条件全包括

2.设置表格为整行选择

self.MyTable.setSelectionBehavior(QAbstractItemView.SelectRows)  #整行选中的方式

 

QAbstractItemView.SelectionBehavior枚举还有如下类型

Constant	Value	Description
QAbstractItemView.SelectItems	0	Selecting single items.选中单个单元格
QAbstractItemView.SelectRows	1	Selecting only rows.选中一行
QAbstractItemView.SelectColumns	2	Selecting only columns.选中一列

 

3.单个选中和多个选中的设置：

self.MyTable.setSelectionMode(QAbstractItemView.ExtendedSelection)  #设置为可以选中多个目标

该函数的参数还可以是：

QAbstractItemView.NoSelection      不能选择

QAbstractItemView.SingleSelection  选中单个目标

QAbstractItemView.MultiSelection    选中多个目标

QAbstractItemView.ExtendedSelection   QAbstractItemView.ContiguousSelection 的区别不明显，主要功能是正常情况下是单选，但按下Ctrl或Shift键后，可以多选

3.表格表头的显示与隐藏

对于水平或垂直方法的表头，可以用以下方式进行 隐藏/显示 的设置：

self.MyTable.verticalHeader().setVisible(False)

self.MyTable.horizontalHeader().setVisible(False)

就将所有的表头都隐藏起来了，效果如下

4.对表头文字的字体、颜色进行设置

 for x in range(self.MyTable.columnCount()):
     headItem = self.MyTable.horizontalHeaderItem(x)   #获得水平方向表头的Item对象
     headItem.setFont(textFont)                        #设置字体
     headItem.setBackgroundColor(QColor(0,60,10))      #设置单元格背景颜色
     headItem.setTextColor(QColor(200,111,30))         #设置文字颜色

 

5.在单元格里加入控件：

QTableWidget不仅允许把文字加到单元格，还允许把控件也放到单元格中。比如，把一个下拉框加入单元格，可以这么做：

 self.MyCombo = QComboBox()
 self.MyCombo.addItem("√")
 self.MyCombo.addItem("×")
 self.MyTable.setCellWidget(1,0,self.MyCombo)

先生成一个QComboBox的对象， 再用QTableWidget类中的setCellWidget函数，将其填入指定的单元格中。

 

 

6.signal 函数的设置

通过实现 itemClicked (QTableWidgetItem *) 信号的槽函数，就可以获得鼠标单击到的单元格指针，进而获得其中的文字信息

首先在__init()__函数中加入

self.connect(self.MyTable, SIGNAL("itemClicked (QTableWidgetItem*)"), self.outSelect)  #将itemClicked信号与函数outSelect绑定

 然后实现一个outSelect函数，如下：

    def outSelect(self, Item=None):
        if Item==None:
            return        
        print(Item.text())

运行程序后，单击一个单元格，即可获得其中的字符了

 

 PS：在使用过程中发现这一connect方式不知为什么不好用，table的所以signal按这个方式connect都不能正常使用。而换成table.[signal].connect([function])后就好用了。比如上一个signal写成table.itemClicked.connect(outSelect)之后就能正常使用了。

 

 第二部分：对单元格的进行设置

1.单元格设置字体颜色和背景颜色

 newItem = QTableWidgetItem("松鼠")
 newItem.setBackgroundColor(QColor(0,60,10))
 newItem.setTextColor(QColor(200,111,100))
 self.MyTable.setItem(0, 0, newItem)

通过QTableWidgetItem类的setBackgroundColor、setTextColor函数来实现

 
        
2.设置单元格中的字体和字符大小

 textFont = QFont("song", 12, QFont.Bold)

 newItem = QTableWidgetItem("松鼠")
 #newItem.setBackgroundColor(QColor(0,60,10))
 #newItem.setTextColor(QColor(200,111,100))
 newItem.setFont(textFont)
 self.MyTable.setItem(0, 0, newItem)

首先，先生成一个字体QFont对象，并将其字体设为宋体，大小设为12，并且加粗

再利用单元格的QTableWidgetItem类中的setFont加载给特定的单元格。如果需要对所有的单元格都使用这种字体，则可以使用

self.MyTable.setFont(testFont)  #利用QTableWidget类中的setFont成员函数，将所有的单元格都设成该字体

 

 

3.设置单元格内文字的对齐方式：

这个比较简单，使用newItem.setTextAlignment()函数即可，该函数的参数为单元格内的对齐方式，和字符输入顺序是自左相右还是自右向左。

水平对齐方式有：

Constant	Value	Description
Qt.AlignLeft	0x0001	Aligns with the left edge.
Qt.AlignRight	0x0002	Aligns with the right edge.
Qt.AlignHCenter	0x0004	Centers horizontally in the available space.
Qt.AlignJustify	0x0008	Justifies the text in the available space.

垂直对齐方式：

Constant	Value	Description
Qt.AlignTop	0x0020	Aligns with the top.
Qt.AlignBottom	0x0040	Aligns with the bottom.
Qt.AlignVCenter	0x0080	Centers vertically in the available space.

如果两种都要设置，只要用 Qt.AlignHCenter |  Qt.AlignVCenter 的方式即可

 

4.合并单元格效果的实现：

self.MyTable.setSpan(0, 0, 3, 1)  # 其参数为： 要改变单元格的   1行数  2列数     要合并的  3行数  4列数

 

 

5.设置单元格的大小

首先，可以指定某个行或者列的大小

self.MyTable.setColumnWidth(2,50)  #将第2列的单元格，设置成50宽度

self.MyTable.setRowHeight(2,60)      #将第2行的单元格，设置成60的高度

 

还可以将行和列的大小设为与内容相匹配

self.MyTable.resizeColumnsToContents()   #将列调整到跟内容大小相匹配
self.MyTable.resizeRowsToContents()      #将行大小调整到跟内容的大学相匹配

 

6 单元格Flag的实现

查看Qt 的文档发现QTableWidgetItem的Flag有很多种。

 

Constant	Value	Description
Qt::NoItemFlags	0	It does not have any properties set.
Qt::ItemIsSelectable	1	It can be selected.
Qt::ItemIsEditable	2	It can be edited.
Qt::ItemIsDragEnabled	4	It can be dragged.
Qt::ItemIsDropEnabled	8	It can be used as a drop target.
Qt::ItemIsUserCheckable	16	It can be checked or unchecked by the user.
Qt::ItemIsEnabled	32	The user can interact with the item.
Qt::ItemIsTristate	64	The item is checkable with three separate states.

 newItem = QtGui.QTableWidgetItem("Del") 
 newItem.setFlags(QtCore.Qt.ItemIsSelectable)

就设置了一个Flag，如果要设置多个，可以 newItem.setFlags(QtCore.Qt.ItemIsSelectable|QtCore.Qt.ItemIsEnabled)

实现图标表示（类似于chrome的常用网站截图）

首先说明对图片的要求。qtablewidget默认处理qtablewidgetitem对象，如果是字符串的话，可以直接选择对齐。但图片或者其他对象的话，默认是不能对齐的（需要使用delegate）。这里例子比较简单，把图片设置成了统一大小，把行列宽和图片大小相匹配，显示的效果还可以。下面附代码：

    def __initPanel(self): # 类成员函数
        from PySide import QtGui, QtCore   #PySide和PyQt4类似，不过PySide更好用，且完全开源，具体请google
        table = self.ui.tableWidget #界面是成员ui，使用pyside-uic生成
        table.setColumnCount(3)
        table.setRowCount(9)
        table.setEditTriggers(QtGui.QAbstractItemView.NoEditTriggers)   # 点击后，信号仍旧发送，只是看起来UI没有变化
        for i in range(3):   # 让列宽和图片相同
            table.setColumnWidth(i , 300)
        for i in range(9):   # 让行高和图片相同
            table.setRowHeight(i , 170)
        for k in range(27): # 27 examples of DDA
            i = k/3
            j = k%3
            item = QtGui.QTableWidgetItem()
            item.setFlags(QtCore.Qt.ItemIsEnabled)  # 不这么设置，用户点击时，图片被选的状态不美观
            item.setIcon(QtGui.QIcon(':/icons/%d.png'%k))
            table.setItem(i,j,item)
        table.cellClicked.connect(self.setupExample4Index) 

效果图：