Qt 实战（10）模型视图 | 10.7、自定义 QTableWidget

一、自定义 QTableWidget

1、创建 QTableWidget

基于VS+Qt创建一个Qt项目，通过Qt Designer创建QTableWidget，完整代码参考附件，界面如下图：

2、设置代理

给地址列设置代理，要求如下：

• QComboBox作为编辑控件。
• 下拉列表内容变更时，发出一个OnCurrentTextChanged信号。

代理代码如下：

QWidget *MyAddrDelegate::createEditor(QWidget *parent, const QStyleOptionViewItem &option, const QModelIndex &index) const
{
    QComboBox *editor = new QComboBox(parent);
    if (editor == nullptr)
        return nullptr;

    QStringList itemList;
    itemList << QString("北京");
    itemList << QString("上海");
    itemList << QString("西安");

    editor->addItems(itemList);
    editor->setFrame(false);
    return editor;
}

void MyAddrDelegate::setEditorData(QWidget *editor, const QModelIndex &index) const
{
    QComboBox *combox = static_cast<QComboBox*>(editor);
    combox->setCurrentIndex(combox->findText(index.model()->data(index, Qt::EditRole).toString()));
}

void MyAddrDelegate::setModelData(QWidget *editor, QAbstractItemModel *model, const QModelIndex &index) const
{
    model->blockSignals(true);
    QComboBox *combox = static_cast<QComboBox*>(editor);
    model->setData(index, combox->currentText(), Qt::EditRole);
    emit OnCurrentTextChanged(index.row(), index.column(), combox->currentText());
    model->blockSignals(false);
}

关键点：

• QComboBox内容变更时，外界如何感知到？

  代理自定义信号OnCurrentTextChanged信号，当更新模型数据时触发这个信号。给"地址"列设置代理时，通过槽函数链接这个信号，如下：

  // MyAddrDelegate.cpp
  // 代理更新模型时发送OnCurrentTextChanged信号
  void MyAddrDelegate::setModelData(QWidget *editor, QAbstractItemModel *model, const QModelIndex &index) const
  {
      model->blockSignals(true);
      QComboBox *combox = static_cast<QComboBox*>(editor);
      model->setData(index, combox->currentText(), Qt::EditRole);
      emit OnCurrentTextChanged(index.row(), index.column(), combox->currentText());
      model->blockSignals(false);
  }
  
  // MyTableWidget.cpp
  // 创建代理时链接信号
  void MyTableWidget::InitDelegate()
  {
      MyAddrDelegate *pAddrDelegate = new MyAddrDelegate();
      ui.m_pTableWidget->setItemDelegateForColumn(1, pAddrDelegate);
      connect(pAddrDelegate, SIGNAL(OnCurrentTextChanged(int, int, QString)), this, SLOT(OnCurrentTextChanged(int, int, QString)));
  }
  

需要注意的点：

• 更新模型数据时，如果不需要触发QTableWidget本身的信号，模型需要屏蔽信号

  setModelData()函数里面的model->setData操作更新模型数据时，会触发QTableWidget::cellChanged()等信号，如果不需要触发这些信号，可以调用model->blockSignals屏蔽信号。

3、给cell设置QWidget

QTableWidget::setCellWidget()支持设置自定义QWidget作为cell的内容，如下：

核心代码如下：

// 设置
QTableWidgetItem *pSettingItem = new QTableWidgetItem();
pSettingItem->setText("");
ui.m_pTableWidget->setItem(row, 3, pSettingItem);

QPushButton *pBtn = new QPushButton(QString::fromStdWString(data.text));
QVBoxLayout *pLayout = new QVBoxLayout();
QWidget *pWidget = new QWidget(this);

pBtn->setFocusPolicy(Qt::FocusPolicy::NoFocus);
pLayout->setContentsMargins(0, 0, 0, 0);
pLayout->addWidget(pBtn);
pWidget->setLayout(pLayout);

connect(pBtn, SIGNAL(clicked()), this, SLOT(OnSettingBtnClicked()));

ui.m_pTableWidget->setCellWidget(row, 3, pWidget);

关键点：

• 单击按键时，如何判断点击那个cell对应的按键

  QTableWidget::indexAt()函数支持根据位置获取cell对应的索引，槽函数可以获取QPushButton对象，通过QPushButton对象的父对象的位置，可以获取到cell对应的索引。如下：

  void MyTableWidget::OnSettingBtnClicked()
  {
      QPushButton *pBtn = qobject_cast<QPushButton *>(sender());
      if (pBtn == nullptr)
          return;
  
      int x = pBtn->parentWidget()->pos().x();
      int y = pBtn->parentWidget()->pos().y();
  
      int row = ui.m_pTableWidget->indexAt(QPoint(x, y)).row();
      int col = ui.m_pTableWidget->indexAt(QPoint(x, y)).column();
      if (row < 0 || row >= ui.m_pTableWidget->rowCount())
          return;
  
      qDebug() << QString("row = %1, col = %2").arg(row).arg(col);
  }