Pyqt的QTableWidget組件的使用

更新時(shí)間：2025年05月14日 09:42:50 作者：爬無止境

QTableWidget是PyQt6中的一個(gè)表格控件,用于顯示和編輯二維表格數(shù)據(jù),本文主要介紹了Pyqt的QTableWidget組件的使用,具有一定的參考價(jià)值,感興趣的可以了解一下

1. 常用方法

1.1 構(gòu)造函數(shù)

QTableWidget(parent: QWidget = None)：創(chuàng)建一個(gè)空的表格控件。
QTableWidget(rows: int, columns: int, parent: QWidget = None)：創(chuàng)建一個(gè)指定行數(shù)和列數(shù)的表格控件。

1.2 設(shè)置行列數(shù)

setRowCount(rows: int)：設(shè)置表格的行數(shù)。
setColumnCount(columns: int)：設(shè)置表格的列數(shù)。
rowCount() -> int：獲取表格的行數(shù)。
columnCount() -> int：獲取表格的列數(shù)。

1.3 設(shè)置表頭

setHorizontalHeaderLabels(labels: List[str])：設(shè)置水平表頭的標(biāo)簽。
setVerticalHeaderLabels(labels: List[str])：設(shè)置垂直表頭的標(biāo)簽。
horizontalHeader() -> QHeaderView：獲取水平表頭對(duì)象。
verticalHeader() -> QHeaderView：獲取垂直表頭對(duì)象。

1.4 設(shè)置單元格內(nèi)容

setItem(row: int, column: int, item: QTableWidgetItem)：設(shè)置指定單元格的內(nèi)容。
item(row: int, column: int) -> QTableWidgetItem：獲取指定單元格的內(nèi)容。
takeItem(row: int, column: int) -> QTableWidgetItem：移除指定單元格的內(nèi)容并返回。

1.5 設(shè)置單元格屬性

setCellWidget(row: int, column: int, widget: QWidget)：在指定單元格中放置一個(gè)控件（如按鈕、下拉框等）。
cellWidget(row: int, column: int) -> QWidget：獲取指定單元格中的控件。
setSpan(row: int, column: int, rowSpan: int, columnSpan: int)：合并單元格。

1.6 選擇模式

setSelectionMode(mode: QAbstractItemView.SelectionMode)：設(shè)置選擇模式（如單選、多選等）。
setSelectionBehavior(behavior: QAbstractItemView.SelectionBehavior)：設(shè)置選擇行為（如選擇行、選擇列等）。

1.7 信號(hào)

cellChanged(row: int, column: int)：當(dāng)單元格內(nèi)容發(fā)生變化時(shí)觸發(fā)。
cellClicked(row: int, column: int)：當(dāng)單元格被點(diǎn)擊時(shí)觸發(fā)。
cellDoubleClicked(row: int, column: int)：當(dāng)單元格被雙擊時(shí)觸發(fā)。

2. 例子

import os
import sys
import webbrowser

import qt_material
from PyQt6.QtWidgets import *
from PyQt6.QtCore import *

class Window(QWidget):
    def __init__(self):
        super(Window, self).__init__()
        self.resize(400, 300)

        self.init_widget()
        self.init_signal()
        self.init_getdata()
        self.init_layout()

    def init_widget(self):
        # tablewidget
        self.table = QTableWidget()
        self.table.setColumnCount(2)
        self.table.setHorizontalHeaderLabels(['網(wǎng)站', 'Url'])
        self.table.horizontalHeader().setSectionResizeMode(QHeaderView.ResizeMode.Stretch)
        self.table.setAlternatingRowColors(True)
        self.table.setEditTriggers(QAbstractItemView.EditTrigger.NoEditTriggers)  # 無法編輯



    def init_getdata(self):
        row_count = self.table.rowCount()
        self.table.setRowCount(row_count + 1)
        self.table.setItem(0, 0, QTableWidgetItem('百度'))
        self.table.setItem(0, 1, QTableWidgetItem('https://www.baidu.com/'))

        row_count = self.table.rowCount()
        self.table.setRowCount(row_count + 1)
        self.table.setItem(1, 0, QTableWidgetItem('騰訊視頻'))
        self.table.setItem(1, 1, QTableWidgetItem('https://v.qq.com/'))

    def init_signal(self):
        self.table.cellDoubleClicked.connect(self.open_url)  # 雙擊打開網(wǎng)頁

    def init_layout(self):
        v_layout = QVBoxLayout()
        v_layout.addWidget(self.table)
        self.setLayout(v_layout)

    def open_url(self, row, column):
        print(f'{row} {column}')
        if int(column) == 1:
            url = self.table.item(row, column).text()
            webbrowser.open(url)


if __name__ == '__main__':
    os.environ["QT_IM_MODULE"] = "ibus"  # mac系統(tǒng)解決輸入法不兼容

    app = QApplication(sys.argv)
    qt_material.apply_stylesheet(app, theme='light_pink.xml')
    window = Window()
    window.show()
    sys.exit(app.exec())