[ PyQt入門教程 ] PyQt5中數據表格控件QTableWidget使用方法

時間 2019-11-16

標籤 pyqt 入門教程 pyqt5 數據表格控件 qtablewidget 使用方法简体版

原文原文鏈接

若是你想讓你開發的PyQt5工具展現的數據顯得整齊、美觀、好看，顯得符合你的氣質，能夠考慮使用QTableWidget控件。以前一直使用的是textBrowser文本框控件，數據展現仍是不太美觀。其中QTableWidget是PyQt5程序中經常使用的顯示數據表格的控件，顯示的基本效果以下，有點素。。程序員

下面開始介紹QTableWidget經常使用的方法以及如何使用。既然是數據表格形式，常用的場景其實跟excel我以爲差很少。開始學習使用QTableWidget以前，咱們帶着以下幾個問題再開始本文的閱讀。app

一、如何在GUI界面上建立QTableWidget表格？指定N行M列，列名稱等等ide

二、如何在表格裏添加每個單元格的數據？函數

三、如何排版數據表格的數據，好比你想單元格內容居中、左對齊、右對齊等。工具

四、如何設置文字顯示顏色、如何設置單元格背景色？佈局

五、如何合併指定單元格，讓排版更合理？學習

基本上使用數據表格展現數據常見的問題就是這些，可以熟練使用QTableWidget解決上述問題，QTableWidget基本使用方法應該就會了。下面開始學習本文內容。字體

QTableWidget經常使用方法

setROwCount(int row) 設置QTableWidget表格控件的行數優化

setColumnCount(int col) 設置QTableWidget表格控件的列數ui

setHorizontalHeaderLabels() 設置QTableWidget表格控件的水平標籤

setVerticalHeaderLabels() 設置QTableWidget表格控件的垂直標籤

setItem(int ,int ,QTableWidgetItem) 在QTableWidget表格控件的每一個選項的單元控件內添加控件

horizontalHeader() 得到QTableWidget表格控件的表格頭，以便執行隱藏

rowCount() 得到QTableWidget表格控件的行數

columnCount() 得到QTableWidget表格控件的列數

setEditTriggers(EditTriggers triggers) 設置表格是否能夠編輯，設置表格的枚舉值

setSelectionBehavior 設置表格的選擇行爲

setTextAlignment() 設置單元格內文本的對齊方式

setSpan(int row,int column,int rowSpanCount,int columnSpanCount) 合併單元格，要改變單元格的第row行，column列，要合併rowSpancount行數和columnSpanCount列數。其中row表示要改變的行數， column表示要改變的列數，rowSpanCount表示須要合併的行數，columnSpanCount表示須要合併的列數。

setShowGrid() 在默認狀況下表格的顯示是有網格的，能夠設置True或False用因而否顯示，默認True

setColumnWidth(int column,int width) 設置單元格行的寬度

setRowHeight(int row,int height) 設置單元格列的高度

這裏的函數有些有點很差理解，好比setSpan()合併單元格函數，你可能一下不知道它的使用方法以及實現效果。不要緊，下面會經過實例講解以及效果演示展現這些函數的使用方法。

QTableWidget使用實例

一、使用designer實現一個包含QTableWidget數據展現控件的窗體。界面設計通常都會採用designer工具，由於要考慮控件間的佈局，純代碼實現會增長難度。界面實現以下

雙擊在窗體界面上的QTableWidget控件，分別選擇Edit Table Widget中Columns、Rows、Items進行編輯。能夠分別完成行、列標題以及單元格內容的添加。

完成後，效果圖以下

二、使用pyuic5工具將.ui文件轉換爲.py文件。

# -*- coding: utf-8 -*-

# Form implementation generated from reading ui file 'cc.ui'
#
# Created by: PyQt5 UI code generator 5.11.3
#
# WARNING! All changes made in this file will be lost!

from PyQt5 import QtCore, QtGui, QtWidgets

class Ui_widget(object):
    def setupUi(self, widget):
        widget.setObjectName("widget")
        widget.resize(730, 574)
        self.tableWidget = QtWidgets.QTableWidget(widget)
        self.tableWidget.setGeometry(QtCore.QRect(10, 130, 701, 192))
        self.tableWidget.setObjectName("tableWidget")
        self.tableWidget.setColumnCount(4)
        self.tableWidget.setRowCount(3)
        item = QtWidgets.QTableWidgetItem()
        self.tableWidget.setVerticalHeaderItem(0, item)
        item = QtWidgets.QTableWidgetItem()
        self.tableWidget.setVerticalHeaderItem(1, item)
        item = QtWidgets.QTableWidgetItem()
        self.tableWidget.setVerticalHeaderItem(2, item)
        item = QtWidgets.QTableWidgetItem()
        item.setTextAlignment(QtCore.Qt.AlignCenter)
        self.tableWidget.setHorizontalHeaderItem(0, item)
        item = QtWidgets.QTableWidgetItem()
        self.tableWidget.setHorizontalHeaderItem(1, item)
        item = QtWidgets.QTableWidgetItem()
        self.tableWidget.setHorizontalHeaderItem(2, item)
        item = QtWidgets.QTableWidgetItem()
        self.tableWidget.setHorizontalHeaderItem(3, item)
        item = QtWidgets.QTableWidgetItem()
        self.tableWidget.setItem(0, 0, item)
        item = QtWidgets.QTableWidgetItem()
        self.tableWidget.setItem(0, 1, item)
        item = QtWidgets.QTableWidgetItem()
        self.tableWidget.setItem(0, 2, item)
        item = QtWidgets.QTableWidgetItem()
        self.tableWidget.setItem(0, 3, item)
        item = QtWidgets.QTableWidgetItem()
        self.tableWidget.setItem(1, 0, item)
        item = QtWidgets.QTableWidgetItem()
        self.tableWidget.setItem(1, 1, item)
        item = QtWidgets.QTableWidgetItem()
        self.tableWidget.setItem(1, 2, item)
        item = QtWidgets.QTableWidgetItem()
        self.tableWidget.setItem(1, 3, item)
        item = QtWidgets.QTableWidgetItem()
        self.tableWidget.setItem(2, 0, item)
        item = QtWidgets.QTableWidgetItem()
        self.tableWidget.setItem(2, 1, item)
        item = QtWidgets.QTableWidgetItem()
        self.tableWidget.setItem(2, 2, item)
        item = QtWidgets.QTableWidgetItem()
        self.tableWidget.setItem(2, 3, item)
        self.tableWidget.horizontalHeader().setCascadingSectionResizes(True)

        self.retranslateUi(widget)
        QtCore.QMetaObject.connectSlotsByName(widget)

    def retranslateUi(self, widget):
        _translate = QtCore.QCoreApplication.translate
        widget.setWindowTitle(_translate("widget", "員工信息表"))
        item = self.tableWidget.verticalHeaderItem(0)
        item.setText(_translate("widget", "1"))
        item = self.tableWidget.verticalHeaderItem(1)
        item.setText(_translate("widget", "2"))
        item = self.tableWidget.verticalHeaderItem(2)
        item.setText(_translate("widget", "3"))
        item = self.tableWidget.horizontalHeaderItem(0)
        item.setText(_translate("widget", "姓名"))
        item = self.tableWidget.horizontalHeaderItem(1)
        item.setText(_translate("widget", "年齡"))
        item = self.tableWidget.horizontalHeaderItem(2)
        item.setText(_translate("widget", "性別"))
        item = self.tableWidget.horizontalHeaderItem(3)
        item.setText(_translate("widget", "基本信息"))
        __sortingEnabled = self.tableWidget.isSortingEnabled()
        self.tableWidget.setSortingEnabled(False)
        item = self.tableWidget.item(0, 0)
        item.setText(_translate("widget", "張三"))
        item = self.tableWidget.item(0, 1)
        item.setText(_translate("widget", "23"))
        item = self.tableWidget.item(0, 2)
        item.setText(_translate("widget", "Male"))
        item = self.tableWidget.item(0, 3)
        item.setText(_translate("widget", "家裏有礦"))
        item = self.tableWidget.item(1, 0)
        item.setText(_translate("widget", "王八"))
        item = self.tableWidget.item(1, 1)
        item.setText(_translate("widget", "25"))
        item = self.tableWidget.item(1, 2)
        item.setText(_translate("widget", "Female"))
        item = self.tableWidget.item(1, 3)
        item.setText(_translate("widget", "拆二代"))
        item = self.tableWidget.item(2, 0)
        item.setText(_translate("widget", "趙四"))
        item = self.tableWidget.item(2, 1)
        item.setText(_translate("widget", "28"))
        item = self.tableWidget.item(2, 2)
        item.setText(_translate("widget", "Male"))
        item = self.tableWidget.item(2, 3)
        item.setText(_translate("widget", "勤奮努力的程序員"))
        self.tableWidget.setSortingEnabled(__sortingEnabled)

附designer工具設計完成的.ui文件代碼。不做展現，方便有須要的讀者下載使用。

<?xml version="1.0" encoding="UTF-8"?>
<ui version="4.0">
 <class>widget</class>
 <widget class="QWidget" name="widget">
  <property name="geometry">
   <rect>
    <x>0</x>
    <y>0</y>
    <width>730</width>
    <height>286</height>
   </rect>
  </property>
  <property name="font">
   <font>
    <pointsize>10</pointsize>
   </font>
  </property>
  <property name="windowTitle">
   <string>員工信息表</string>
  </property>
  <widget class="QTableWidget" name="tableWidget">
   <property name="geometry">
    <rect>
     <x>10</x>
     <y>51</y>
     <width>701</width>
     <height>211</height>
    </rect>
   </property>
   <attribute name="horizontalHeaderCascadingSectionResizes">
    <bool>true</bool>
   </attribute>
   <row>
    <property name="text">
     <string>1</string>
    </property>
   </row>
   <row>
    <property name="text">
     <string>2</string>
    </property>
   </row>
   <row>
    <property name="text">
     <string>3</string>
    </property>
   </row>
   <column>
    <property name="text">
     <string>姓名</string>
    </property>
    <property name="textAlignment">
     <set>AlignCenter</set>
    </property>
   </column>
   <column>
    <property name="text">
     <string>年齡</string>
    </property>
   </column>
   <column>
    <property name="text">
     <string>性別</string>
    </property>
   </column>
   <column>
    <property name="text">
     <string>基本信息</string>
    </property>
   </column>
   <item row="0" column="0">
    <property name="text">
     <string>張三</string>
    </property>
   </item>
   <item row="0" column="1">
    <property name="text">
     <string>23</string>
    </property>
   </item>
   <item row="0" column="2">
    <property name="text">
     <string>Male</string>
    </property>
   </item>
   <item row="0" column="3">
    <property name="text">
     <string>家裏有礦</string>
    </property>
   </item>
   <item row="1" column="0">
    <property name="text">
     <string>王八</string>
    </property>
   </item>
   <item row="1" column="1">
    <property name="text">
     <string>25</string>
    </property>
   </item>
   <item row="1" column="2">
    <property name="text">
     <string>Female</string>
    </property>
   </item>
   <item row="1" column="3">
    <property name="text">
     <string>拆二代</string>
    </property>
   </item>
   <item row="2" column="0">
    <property name="text">
     <string>趙四</string>
    </property>
   </item>
   <item row="2" column="1">
    <property name="text">
     <string>28</string>
    </property>
   </item>
   <item row="2" column="2">
    <property name="text">
     <string>Male</string>
    </property>
   </item>
   <item row="2" column="3">
    <property name="text">
     <string>勤奮努力的程序員</string>
    </property>
   </item>
  </widget>
  <widget class="QLabel" name="label">
   <property name="geometry">
    <rect>
     <x>250</x>
     <y>20</y>
     <width>111</width>
     <height>21</height>
    </rect>
   </property>
   <property name="font">
    <font>
     <family>YaHei Consolas Hybrid</family>
     <pointsize>10</pointsize>
    </font>
   </property>
   <property name="text">
    <string>員工信息展現</string>
   </property>
  </widget>
 </widget>
 <resources/>
 <connections/>
</ui>

View Code

三、編寫主程序，調用界面.py文件。使業界面和邏輯程序分離，這樣的好處就是後面界面任何改動程序邏輯幾乎不會有什麼大的影響。

# -*- coding: utf-8 -*-

# Form implementation generated from reading ui file 'connect_me.ui'
#
# Created by: PyQt5 UI code generator 5.11.3
#
# WARNING! All changes made in this file will be lost!
#導入程序運行必須模塊
import sys
from PyQt5.QtWidgets import *
from PyQt5.QtGui import QColor, QBrush
from cc import Ui_widget


class MyMainForm(QMainWindow, Ui_widget):
    def __init__(self, parent=None):
        super(MyMainForm, self).__init__(parent)
        self.setupUi(self)

if __name__ == "__main__":
    app = QApplication(sys.argv)
    myWin = MyMainForm()
    myWin.show()
    sys.exit(app.exec_())

運行程序結果以下：

四、程序運行能夠正常顯示界面，可是界面並非很美觀（好比行、列沒有鋪滿整個顯示窗口、列標題文字沒有加粗等）。下面經過QTableWidget相關函數的使用來實現優化。

QTableWidget函數使用方法

上述基本例子實現了員工信息表格展現的初始化，單元格內容手工添加其實在實現場景不合適，只是方便展現，下面講解如何經過代碼實現方式添加單元格內容以及實現單元格內容顏色、字體變化的實現。說明，下述全部代碼添加都在主程序中完成。目的是使程序實現更靈活，方便維護。

（1）初始化QTableWidget數據展現窗口對象。通常來講該步驟一般是經過designer實現。

self.tableWidget = QtWidgets.QTableWidget(widget) self.tableWidget.setColumnCount(4) self.tableWidget.setRowCount(3)

設置表格的行、列標題，以下：

self.tableWidget.setHorizontalHeaderLabels(['姓名','年齡']) self.tableWidget.setVerticalHeaderLabels(['1','2'])

固然也能夠經過上面例子中的方式去添加，以下：

item = QtWidgets.QTableWidgetItem()
self.tableWidget.setVerticalHeaderItem(1, item)

item = QtWidgets.QTableWidgetItem()
self.tableWidget.setHorizontalHeaderItem(1, item)

（2）設置表格頭的伸縮模式，也就是讓表格鋪滿整個QTableWidget控件。

self.tableWidget.horizontalHeader().setSectionResizeMode(QHeaderView.Stretch)
效果以下：

（2）將表格變爲禁止編輯。默認狀況下表格中的字符串是能夠更改的，好比雙擊一個單元格，就能夠修改運來的內容。若是想禁止這種操做，讓表格對用戶是隻讀的，能夠添加以下代碼。

self.tableWidget.setEditTriggers(QAbstractItemView.NoEditTriggers)

運行效果（雙擊單元格不可編輯，提早觀察一下鼠標單擊選中的只是單元格）：

（3）設置表格整行選中。表格默認選中的是單個單元格。經過下面代碼能夠設置成選中整行。添加代碼以下

self.tableWidget.setSelectionBehavior(QAbstractItemView.SelectRows)

運行效果以下：

（4）行、列標題的顯示與隱藏。

對於列標題的顯示或隱藏設置，能夠經過添加以下代碼實現。默認是顯示的。

self.tableWidget.horizontalHeader().setVisible(False)

運行效果以下（行標題再也不顯示）：

對於行標題，可使用以下代碼進行隱藏或顯示設置。默認是顯示

self.tableWidget.verticalHeader().setVisible(

（5）在表格中添加內容。代碼以下：

        items = [['燕十三','21','Male','武林大俠'],['蕭十一郎','21','Male','武功好']]

        for i in range(len(items)):
            item = items[i]
            row = self.tableWidget.rowCount()
            self.tableWidget.insertRow(row)
            for j in range(len(item)):
                item = QTableWidgetItem(str(items[i][j]))
                self.tableWidget.setItem(row,j,item)

運行結果以下：

（6）設置表格標題字體加粗。添加代碼以下：

font = self.tableWidget.horizontalHeader().font()
font.setBold(True)
self.tableWidget.horizontalHeader().setFont(font)

運行效果以下

（7）設置表格指定列寬。添加代碼以下：

self.tableWidget.horizontalHeader().resizeSection(0,100)
self.tableWidget.horizontalHeader().resizeSection(1,100)
self.tableWidget.horizontalHeader().resizeSection(1,100)
self.tableWidget.horizontalHeader().resizeSection(3,400)
#self.tableWidget.horizontalHeader().setSectionResizeMode(QHeaderView.Stretch) 必定要註釋，不然上述設置不生效

說明，表頭的自適應模式要註釋，不然上述設置不生效。運行效果以下：

（8）合併單元格，添加以下代碼

self.tableWidget.setSpan(0,3,2,1)

運行結果以下：

這裏再補充描述一下setSpan()函數。setSpan(0,3,2,1)函數中（0,3）會指定到單元格第1行第4列（下標都是從0開始計算），（2,1）分別表示合併2行（把下一行合併了），1列（1列，列其實沒有合併）。咱們把代碼修改成setSpan(1,2,3,2)。看效果以下（很直觀了吧）：

（9）對齊單元格中的內容。添加代碼以下：

for i in range(len(items)):
    each_item = items[i]
    row = self.tableWidget.rowCount()
    self.tableWidget.insertRow(row)
    for j in range(len(each_item)):
        item = QTableWidgetItem(str(items[i][j]))
        if j != len(each_item) -1:
            item.setTextAlignment(Qt.AlignHCenter | Qt.AlignVCenter)
        self.tableWidget.setItem(row,j,item)

關鍵代碼就是item.setTextAlignment(Qt.AlignHCenter | Qt.AlignVCenter)。前面3列居中顯示，最後一列靠左顯示。運行效果以下：

（10）設置單元格字體顏色和背景顏色。添加代碼以下：

for i in range(len(items)):
    each_item = items[i]
    row = self.tableWidget.rowCount()
    self.tableWidget.insertRow(row)
    for j in range(len(each_item)):
        item = QTableWidgetItem(str(items[i][j]))
        if j != len(each_item) -1:
            item.setTextAlignment(Qt.AlignHCenter | Qt.AlignVCenter)
            item.setForeground(QBrush(QColor(255,0,0))) #設置除最後一列外的文字顏色爲紅色 else:
            item.setBackground(QBrush(QColor(0,255,0))) #設置最後一列的背景色爲綠色
        self.tableWidget.setItem(row,j,item)

運行結果以下所示：

QTableWidget控件的基本使用方法就到這裏，後續有其餘更好的使用技巧會繼續更新，爲方便本身及你們閱讀本文，附本文使用到的代碼以下：

# -*- coding: utf-8 -*-

# Form implementation generated from reading ui file 'connect_me.ui'
#
# Created by: PyQt5 UI code generator 5.11.3
#
# WARNING! All changes made in this file will be lost!
#導入程序運行必須模塊
import sys
from PyQt5.QtWidgets import *
from PyQt5.QtGui import QColor, QBrush
from PyQt5.QtCore import Qt
from cc import Ui_widget


class MyMainForm(QMainWindow, Ui_widget):
    def __init__(self, parent=None):
        super(MyMainForm, self).__init__(parent)
        self.setupUi(self)
        #self.tableWidget.horizontalHeader().setSectionResizeMode(QHeaderView.Stretch)
        self.tableWidget.setEditTriggers(QAbstractItemView.NoEditTriggers)
        self.tableWidget.setSelectionBehavior(QAbstractItemView.SelectRows)
        #self.tableWidget.horizontalHeader().setVisible(False)
        self.tableWidget.verticalHeader().setVisible(False)
        font = self.tableWidget.horizontalHeader().font()
        font.setBold(True)
        self.tableWidget.horizontalHeader().setFont(font)
        self.tableWidget.horizontalHeader().resizeSection(0,100)
        self.tableWidget.horizontalHeader().resizeSection(1,100)
        self.tableWidget.horizontalHeader().resizeSection(1,100)
        self.tableWidget.horizontalHeader().resizeSection(3,400)
        #self.tableWidget.horizontalHeader().setSectionResizeMode(QHeaderView.Stretch)

        items = [['燕十三','21','Male','武林大俠'],['蕭十一郎','21','Male','武功好']]
        for i in range(len(items)):
            each_item = items[i]
            row = self.tableWidget.rowCount()
            self.tableWidget.insertRow(row)
            for j in range(len(each_item)):
                item = QTableWidgetItem(str(items[i][j]))
                if j != len(each_item) -1:
                    item.setTextAlignment(Qt.AlignHCenter | Qt.AlignVCenter)
                    item.setForeground(QBrush(QColor(255,0,0)))
                else:
                    item.setBackground(QBrush(QColor(0,255,0)))
                self.tableWidget.setItem(row,j,item)

        self.tableWidget.setSpan(1,2,3,2)

if __name__ == "__main__":
    app = QApplication(sys.argv)
    myWin = MyMainForm()
    myWin.show()
    sys.exit(app.exec_())

總結

本文描述PyQt5的QTableWidget控件的基本使用方法和效果，界面實現建議仍是desiger設計工具實現，同時使用業務和邏輯相分離的方式編寫程序，都揉在一塊後面程序就很差維護，畢竟沒有誰的工具實現是能夠一蹴而就的，仍是要考慮可維護性。讀完本文內容相信讀者就能夠上手使用QTableWidget控件了。。

相關標籤/搜索

每日一句

每一个你不满意的现在，都有一个你没有努力的曾经。