Pyqt 的QTableWidget组件

原创已于 2025-02-08 20:21:41 修改 · 1.3k 阅读

10 ·

CC 4.0 BY-SA版权

文章标签：

#pyqt

于 2025-02-08 20:18:37 首次发布

PyQt基础知识专栏收录该内容

12 篇文章

订阅专栏

QTableWidget 是 PyQt6 中的一个表格控件，用于显示和编辑二维表格数据。它继承自 QTableView，提供了更简单的方式来处理表格数据，适合用于需要展示结构化数据的场景。

1. 常用方法

1.1 构造函数

QTableWidget(parent: QWidget = None)：创建一个空的表格控件。
QTableWidget(rows: int, columns: int, parent: QWidget = None)：创建一个指定行数和列数的表格控件。

1.2 设置行列数

setRowCount(rows: int)：设置表格的行数。
setColumnCount(columns: int)：设置表格的列数。
rowCount() -> int：获取表格的行数。
columnCount() -> int：获取表格的列数。

1.3 设置表头

setHorizontalHeaderLabels(labels: List[str])：设置水平表头的标签。
setVerticalHeaderLabels(labels: List[str])：设置垂直表头的标签。
horizontalHeader() -> QHeaderView：获取水平表头对象。
verticalHeader() -> QHeaderView：获取垂直表头对象。

1.4 设置单元格内容

setItem(row: int, column: int, item: QTableWidgetItem)：设置指定单元格的内容。
item(row: int, column: int) -> QTableWidgetItem：获取指定单元格的内容。
takeItem(row: int, column: int) -> QTableWidgetItem：移除指定单元格的内容并返回。

1.5 设置单元格属性

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

1.6 选择模式

setSelectionMode(mode: QAbstractItemView.SelectionMode)：设置选择模式（如单选、多选等）。
setSelectionBehavior(behavior: QAbstractItemView.SelectionBehavior)：设置选择行为（如选择行、选择列等）。

1.7 信号

cellChanged(row: int, column: int)：当单元格内容发生变化时触发。
cellClicked(row: int, column: int)：当单元格被点击时触发。
cellDoubleClicked(row: int, column: int)：当单元格被双击时触发。

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(['网站', '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)  # 双击打开网页

    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系统解决输入法不兼容

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