当前位置：首页 > news >正文

qt QAbstractTableModel详解

news 2024/11/6 12:51:38

1、概述

QAbstractTableModel 是 Qt 框架中的一个类，用于在 Qt 应用程序中实现自定义的表格数据模型。它是 Qt 中的一个抽象基类，提供了创建和操作表格数据所需的接口。QAbstractTableModel 为模型提供了一个标准接口，这些模型将其数据表示为二维项目数组，适用于向 QTableView 或 QML 中的 TableView 组件提供数据，用于显示和编辑。

2、重要方法

QAbstractTableModel 中有几个重要的方法需要子类实现或重写，这些方法定义了表格的数据源和结构：

rowCount()：返回表格的行数。
columnCount()：返回表格的列数。
data(int row, int column, int role = Qt::DisplayRole)：返回指定单元格的数据。row 和 column 分别表示行和列的索引，role 表示数据的角色（如显示文本、字体、对齐方式等）。
headerData(int section, Qt::Orientation orientation, int role = Qt::DisplayRole)：返回表头的数据。section 表示列或行的索引，orientation 表示方向（水平或垂直），role 表示数据的角色。
flags(const QModelIndex &index) const：返回指定单元格的标志，用于控制单元格是否可编辑、可选择等。

此外，如果模型支持数据的插入和删除，还需要实现以下方法：

insertRows(int row, int count, const QModelIndex &parent = QModelIndex())
removeRows(int row, int count, const QModelIndex &parent = QModelIndex())
insertColumns(int column, int count, const QModelIndex &parent = QModelIndex())
removeColumns(int column, int count, const QModelIndex &parent = QModelIndex())

在实现这些方法时，需要调用 beginInsertRows()、endInsertRows()、beginRemoveRows()、endRemoveRows()、beginInsertColumns()、endInsertColumns()、beginRemoveColumns() 和 endRemoveColumns() 等函数，以便通知所有连接的视图关于模型的更改。

3、重要信号

QAbstractTableModel 还发出一些重要的信号，用于通知视图关于模型的更改：

dataChanged(const QModelIndex &topLeft, const QModelIndex &bottomRight, const QVector<int> &roles = QVector<int>() const)：当模型中某个范围的数据发生更改时发出此信号。
headerDataChanged(Qt::Orientation orientation, int first, int last)：当模型的表头数据发生更改时发出此信号。
layoutChanged()：当模型的底层数据结构发生变化，导致整个布局需要重新绘制时发出此信号。

4、重要角色和标志

以下是QAbstractTableModel 类中一些常见的角色和标志及其简要介绍:

角色(Role)

Qt::DisplayRole:用于显示的数据。
Qt::EditRole:用于编辑的数据。
Qt::ToolTipRole:用于显示工具提示的数据。
Qt::DecorationRole:用于显示装饰图标的数据。
Qt::CheckstateRole:用于显示复选框状态的数据。

标志(Flags)

Qt::ItemIsSelectable:项是可选中的。
Qt::ItemIsEditable:项是可编辑的。
Qt::ItemIsEnabled:项是启用的。
Qt::ItemIsUserCheckable:项是用户可复选的。

#include <QApplication>
#include <QMainWindow>
#include <QTableView>
#include <QVariant>
#include <QVector>class TableModel : public QAbstractTableModel
{Q_OBJECTpublic:TableModel(QObject *parent = nullptr) : QAbstractTableModel(parent){// 初始化数据dataList = {{"Alice", "30", "Engineer"},{"Bob", "25", "Designer"},{"Charlie", "35", "Manager"}};}// 获取行数int rowCount(const QModelIndex &parent = QModelIndex()) const override{if (parent.isValid()) return 0;return dataList.size();}// 获取列数int columnCount(const QModelIndex &parent = QModelIndex()) const override{if (parent.isValid()) return 0;return dataList.isEmpty() ? 0 : dataList[0].size();}// 获取数据项的值QVariant data(const QModelIndex &index, int role = Qt::DisplayRole) const override{if (!index.isValid() || role != Qt::DisplayRole)return QVariant();return dataList[index.row()][index.column()];}// 标题QVariant headerData(int section, Qt::Orientation orientation, int role = Qt::DisplayRole) const override{if (role != Qt::DisplayRole)return QVariant();if (orientation == Qt::Horizontal) {switch (section) {case 0: return "Name";case 1: return "Age";case 2: return "Occupation";}}return QVariant();}// 设置数据项的值bool setData(const QModelIndex &index, const QVariant &value, int role = Qt::EditRole) override{if (index.isValid() && role == Qt::EditRole) {dataList[index.row()][index.column()] = value.toString();emit dataChanged(index, index, {role});return true;}return false;}// 获取数据项的标志属性Qt::ItemFlags flags(const QModelIndex &index) const override{if (!index.isValid())return Qt::NoItemFlags;return Qt::ItemIsSelectable | Qt::ItemIsEditable | Qt::ItemIsEnabled;}// 插入新行bool insertRows(int position, int rows, const QModelIndex &parent = QModelIndex()) override{beginInsertRows(QModelIndex(), position, position + rows - 1);for (int row = 0; row < rows; ++row) {dataList.insert(position, {"", "", ""});}endInsertRows();return true;}// 移除行bool removeRows(int position, int rows, const QModelIndex &parent = QModelIndex()) override{beginRemoveRows(QModelIndex(), position, position + rows - 1);for (int row = 0; row < rows; ++row) {dataList.removeAt(position);}endRemoveRows();return true;}private:QVector<QVector<QString>> dataList;
};int main(int argc, char *argv[])
{QApplication app(argc, argv);// 创建主窗口QMainWindow mainWindow;mainWindow.setWindowTitle("QAbstractTableModel Example");mainWindow.resize(400, 300);// 创建自定义表模型TableModel *model = new TableModel;// 创建表视图QTableView *tableView = new QTableView;tableView->setModel(model);tableView->horizontalHeader()->setStretchLastSection(true);tableView->setEditTriggers(QAbstractItemView::DoubleClicked);// 布局管理QVBoxLayout *layout = new QVBoxLayout;layout->addWidget(tableView);QWidget *centralWidget = new QWidget;centralWidget->setLayout(layout);mainWindow.setCentralWidget(centralWidget);// 显示主窗口mainWindow.show();return app.exec();
}