QTableWidget

原创已于 2024-11-26 11:02:07 修改 · 926 阅读

13 ·

CC 4.0 BY-SA版权

文章标签：

#qt

于 2024-11-23 10:29:38 首次发布

QTableWidget 专栏收录该内容

17 篇文章

订阅专栏

QTableWidget是Qt框架中的一个重要控件，用于展示和编辑二维表格数据。它基于QTableView和QStandardItemModel的封装，但提供了更为简便的接口，使得处理常见的表格操作需求变得更加容易。以下是对QTableWidget的详细介绍：

一、QTableWidget的特点

数据表示：QTableWidget以行和列的形式组织数据，每个单元格由一个QTableWidgetItem对象表示，可以包含文本、图标或其他数据类型。
简单易用：相比QTableView，QTableWidget提供了更多的直接操作方法，如插入、删除行或列，以及直接访问和修改单元格内容。
编辑功能：用户可以直接在表格中编辑单元格内容，支持文本编辑、复选框、按钮等多种编辑模式。
表头管理：可以自定义行列表头，行列表头默认是不可编辑的，用于标识各列或行的数据含义。
选择模式：支持多种选择模式，如单选、多选、行选或列选等。
样式定制：可以通过设置样式表来改变QTableWidget的外观，包括单元格颜色、字体、边框等。
信号与槽机制：QTableWidget支持Qt的信号与槽机制，可以轻松地响应用户交互，如单元格点击、内容改变等事件。

二、QTableWidget的基础使用

引入QTableWidget：要使用QTableWidget，首先需要在Qt项目中包含相应的头文件，并在UI设计中或在代码中创建其实例。
设置行数和列数：可以通过setRowCount()和setColumnCount()设置表格的行数和列数。
设置单元格内容：通过setItem(int row, int column, QTableWidgetItem *item)设置指定单元格的表格项。
设置表头：分为水平表头（列表头）和垂直表头（行表头），可通过setHorizontalHeaderLabels()和setVerticalHeaderLabels()设置标签。

三、QTableWidget的高级功能

数据表示与编辑：QTableWidget支持在单元格里存取常见类型数据和自定义类型的数据。
表格操作：可以清空表格所有数据、获取表格的总行数和总列数、插入和获取数据等。
表头管理：可以自定义表头样式，如设置列宽、表头字体加粗、表头背景色等。
排序与搜索：QTableWidget支持对表格数据进行排序和搜索操作。
拖放功能：用户可以通过拖放操作来重新排列表格中的行或列。

四、QTableWidget的代码示例

以下是一个简单的示例代码，展示了如何创建一个包含几行几列的QTableWidget，并设置一些单元格的文本：

#include <QApplication>
#include <QTableWidget>
#include <QTableWidgetItem>

int main(int argc, char *argv[]) {
    QApplication app(argc, argv);

    QTableWidget tableWidget(4, 3); // 创建一个4行3列的表格
    tableWidget.setHorizontalHeaderLabels(QStringList() << "姓名" << "年龄" << "职业"); // 设置水平表头

    // 设置一些单元格的文本
    QTableWidgetItem *item = new QTableWidgetItem("张三");
    tableWidget.setItem(0, 0, item);
    tableWidget.setItem(0, 1, new QTableWidgetItem("30"));
    tableWidget.setItem(0, 2, new QTableWidgetItem("软件工程师"));

    // ... 为其他单元格设置文本（省略）

    tableWidget.show();

    return app.exec();
}