向QAbstractItemView子类如:QTreeView、QTableView等子项单元格插入窗体小部件的功能实现(第1种方法)

目录

1.前言

2.利用QAbstractItemView类的setIndexWidget函数实现

3.后记

---

1.前言

工作中经常会遇到这样的需求：向QAbstractItemView子类如QTreeView、QTableView单元格插入窗体小部件，如：进度条、按钮、单行编辑框等。下面链接的系列博文就是讲解如何实现该功能的。

• 《向QAbstractItemView子类如:QTreeView、QTableView等子项单元格插入窗体小部件的功能实现(第1种方法)》。

• 《向QAbstractItemView子类如:QTreeView、QTableView等子项单元格插入窗体小部件的功能实现(第2种方法)》。

• 《向QAbstractItemView子类如:QTreeView、QTableView等子项单元格插入窗体小部件的功能实现(第3种方法)》。

这些系列博文所说的技术点适用于同时满足下面条件的所有类：

• 模型类从 QAbstractItemModel派生。

• 代理类从QStyledItemDelegate或QItemDelegate派生。

• 视图类是QAbstractItemView的子类。

这些系列博文用到了Qt的model/view framework框架,如果对Qt的“模型/视图/代理”框架不懂，这些系列文章很难读懂。如果不懂这方面的知识，请在Qt Assistant 中输入Model/View Programming 学习了解。读者本机Qt安装目录下的Examples\Qt-XX.XX.XX\widgets\itemviews目录下有很多model/view framework的例子，可以进行自学了解，其中XX.XX.XX为Qt的版本号，如：5.14.1。

因为QColumnView、QHeaderView、QListView、QTableView、QTreeView、QListWidget 、QUndoView、QTableWidget、QTreeWidget都是从QAbstractItemView继承，故这些系列博文所说的技术点也适用于这些类。

本博文通过Qt的QAbstractItemView视图基类自带的函数来实现该功能。

2.利用QAbstractItemView类的setIndexWidget函数实现

QAbstractItemView类有个setIndexWidget函数，该函数声明如下：

void QAbstractItemView::setIndexWidget(const QModelIndex &index, QWidget *widget)

第1个参数是模型索引，你可以想象为就是一个单元格所在的行列索引号。如果该参数无效，例如是根节点索引时，则这个函数什么都不做。

第2个参数是单元格要插入的窗体部件。注意：窗体部件autoFillBackground 属性要设置为true,否则窗体背景色是透明的。如果在指定索引处的A窗体被后来的窗体B替换，则A窗体被删除，如下：

 
  setIndexWidget(index, new QLineEdit);
  ...
  setIndexWidget(index, new QTextEdit);

则QLineEdit会被删除。本函数仅仅能用来根据项的数据在可见区域显示一些静态内容，如果需要显示一些动态内容或者显示一个自定义的编辑框部件，需通过子类化QStyledItemDelegate类实现。

以QTableView为例子来说明。 为了给QTableView提供数据，必须实现一个模型即从QAbstractTableModel.类派生出自己的模型类来，模型类model.cpp代码如下：

#include "model.h"
CModel::CModel(QObject *parent)
    : QAbstractTableModel(parent)
{}
 
CModel::~CModel()
{}
 
QVariant CModel::data(const QModelIndex& index, int role/* = Qt::DisplayRole*/) const
{
    return QVariant();
}
 
// 作为例子，假想QTableView有2列
int CModel::columnCount(const QModelIndex& parent/* = QModelIndex()*/) const
{
    return 2;
}
 
// 作为例子，假想QTableView有88行
int CModel::rowCount(const QModelIndex& parent/* = QModelIndex()*/) const
{
    return 88;
}
 
QVariant CModel::headerData(int section, Qt::Orientation orientation, int role /*= Qt::DisplayRole*/) const
{
    if (orientation != Qt::Horizontal) // 作为例子演示，我们只关心表头是水平的情况
        return QVariant();
 
    if (role != Qt::DisplayRole)// 作为例子演示，我们只关心 Qt::DisplayRole
        return QVariant();
 
    // 构造列，第1列列名为"button"；第2列列名为"checkbox"
    if(0 == section)
     return "button";
    else if(1 == section)
        return "checkbox";
 
    return QVariant();
}

QtWidgetsApplication1.cpp实现如下：

#include "QtWidgetsApplication1.h"
#include "model.h"
#include<QPushButton>
#include<QScrollBar>
#include<QCheckBox>
QtWidgetsApplication1::QtWidgetsApplication1(QWidget *parent)
    : QWidget(parent)
{
    ui.setupUi(this);
 
    m_pModel = new CModel(this); // new出一个模型对象
    ui.tableView->setModel(m_pModel);// 将表格视图的模型对象设置为上步构建出来的模型对象

    installWidget();
}

void QtWidgetsApplication1::installWidget()
{
    auto nRowCount = m_pModel->rowCount();   // 获取表视图有多少行
    auto nColCount = m_pModel->columnCount();// 获取表视图有多少列
 
  // 表视图对象中的每行第0列插入一个QPushButton按钮，在第1列插入一个QCheckBox对象
    for (auto nRowIndx = 0; nRowIndx < nRowCount; ++nRowIndx)
    {
        auto modelIndx = m_pModel->index(nRowIndx, 0);
        QString qsText(QString("button%1").arg(nRowIndx));
        ui.tableView->setIndexWidget(modelIndx, new QPushButton(qsText, this));
 
        modelIndx = m_pModel->index(nRowIndx, 1);
        qsText = (QString("checkbox%1").arg(nRowIndx));
        ui.tableView->setIndexWidget(modelIndx, new QCheckBox(qsText, this));
    }
}
 

installWidget函数利用setIndexWidget函数在表视图对象中的每行第0列插入一个QPushButton按钮，在第1列插入一个QCheckBox对象。效果如下：

3.后记

如果是QTableWidget类，则也可以用如下函数插入窗体小部件：

void QTableWidget::setCellWidget(int row, int column, QWidget *widget)

如下代码：

setCellWidget(row, column, new QLineEdit);
setCellWidget(row, column + 1, new QTextEdit);

实现向第row行的column列和column+1列分别插入了一个QLineEdit和一个QTextEdit窗体小部件。