Qt QTableWidget用法总结

 QTableWidget是QT程序中常用的显示数据表格的空间，很类似于VC、C#中的DataGrid。说到QTableWidget，就必须讲一下它跟QTabelView的区别了。

QTableWidget是QTableView的子类，主要的区别是QTableView可以使用自定义的数据模型来显示内容(也就是先要通过setModel来绑定数据源)，而QTableWidget则只能使用标准的数据模型，并且其单元格数据是QTableWidgetItem的对象来实现的(也就是不需要数据源，将逐个单元格内的信息填好即可)。这主要体现在QTableView类中有setModel成员函数，而到了QTableWidget类中，该成员函数变成了私有。使用QTableWidget就离不开QTableWidgetItem。QTableWidgetItem用来表示表格中的一个单元格，整个表格都需要用逐个单元格构建起来。

简单示例，效果如下：

源代码如下：

#include 
#include 
#include 

int main(int argc, char *argv[])
{
    QApplication a(argc, argv);
    // 构造了一个QTableWidget的对象，并且设置为10行，5列
    QTableWidget *tableWidget = new QTableWidget(10,5);
    // 也可用下面的方法构造QTableWidget对象
    // QTableWidget *tableWidget = new QTableWidget;
    // tableWidget->setRowCount(10); //设置行数为10
    // tableWidget->setColumnCount(5); //设置列数为5
    tableWidget->setWindowTitle("QTableWidget & Item");
    tableWidget->resize(350, 200); //设置表格
    QStringList header;
    header<<"Month"<<"Description";
    tableWidget->setHorizontalHeaderLabels(header);
    tableWidget->setItem(0,0,new QTableWidgetItem("Jan"));
    tableWidget->setItem(1,0,new QTableWidgetItem("Feb"));
    tableWidget->setItem(2,0,new QTableWidgetItem("Mar"));

    tableWidget->setItem(0,1,new QTableWidgetItem(QIcon(":/Image/IED.png"), "Jan's month"));
    tableWidget->setItem(1,1,new QTableWidgetItem(QIcon(":/Image/IED.png"), "Feb's month"));
    tableWidget->setItem(2,1,new QTableWidgetItem(QIcon(":/Image/IED.png"), "Mar's month"));
    tableWidget->show();

    return a.exec();
}

一. 对QTableWidget本身的效果实现 

1. 将表格变为禁止编辑

在默认情况下，表格里的字符是可以更改的，比如双击一个单元格，就可以修改原来的内容，如果想禁止用户的这种操作，让这个表格对用户只读，可以这样：

tableWidget->setEditTriggers(QAbstractItemView::NoEditTriggers);

QAbstractItemView::NoEditTriggers是QAbstractItemView.EditTrigger枚举中的一个，都是触发修改单元格内容的条件：

QAbstractItemView::NoEditTriggers  0  不能对表格内容进行修改
QAbstractItemView::CurrentChanged  1  任何时候都能对单元格修改
QAbstractItemView::DoubleClicked  2  双击单元格
QAbstractItemView::SelectedClicked  4  单击已选中的内容
QAbstractItemView::EditKeyPressed  8  Editing starts when the platform edit key has been pressed over an item.
QAbstractItemView::AnyKeyPressed  16  按下任意键就能修改
QAbstractItemView::AllEditTriggers  31 以上条件全包括

2. 设置表格为整行选择 
 

tableWidget->setSelectionBehavior(QAbstractItemView::SelectRows); //整行选中的方式

QAbstractItemView.SelectionBehavior枚举还有如下类型

Constant  Value  Description
QAbstractItemView::SelectItems  0  Selecting single items.选中单个单元格
QAbstractItemView::SelectRows  1  Selecting only rows.选中一行
QAbstractItemView::SelectColumns  2  Selecting only columns.选中一列

3.单个选中和多个选中的设置：
 

tableWidget->setSelectionMode(QAbstractItemView::ExtendedSelection); //设置为可以选中多个目标

该函数的参数还可以是：

QAbstractItemView::NoSelection 不能选择

QAbstractItemView::SingleSelection 选中单个目标

QAbstractItemView::MultiSelection 选中多个目标

QAbstractItemView::ExtendedSelection QAbstractItemView::ContiguousSelection 的区别不明显，主要功能是正常情况下是单选，但按下Ctrl或Shift键后，可以多选

4. 表格表头的显示与隐藏

对于水平或垂直方法的表头，可以用以下方式进行 隐藏/显示 的设置：注意：需要 #include

tableWidget->verticalHeader()->setVisible(false); //隐藏列表头 
tableWidget->horizontalHeader()->setVisible(false); //隐藏行表头

5. 对表头文字的字体、颜色进行设置   注意：需要 #include

QTableWidgetItem *columnHeaderItem0 = tableWidget->horizontalHeaderItem(0); //获得水平方向表头的Item对象 
columnHeaderItem0->setFont(QFont("Helvetica")); //设置字体 
columnHeaderItem0->setBackgroundColor(QColor(0,60,10)); //设置单元格背景颜色 
columnHeaderItem0->setTextColor(QColor(200,111,30)); //设置文字颜色 

6. 在单元格里加入控件：

QTableWidget不仅允许把文字加到单元格，还允许把控件也放到单元格中。比如，把一个下拉框加入单元格，可以这么做：

QComboBox *comBox = new QComboBox(); 
comBox->addItem("Y"); 
comBox->addItem("N"); 
tableWidget->setCellWidget(0,2,comBox); 

 二. 对单元格的进行设置 

1. 单元格设置字体颜色和背景颜色 及字体字符

QTableWidgetItem *item = new QTableWidgetItem("Apple"); 
item->setBackgroundColor(QColor(0,60,10)); 
item->setTextColor(QColor(200,111,100)); 
item->setFont(QFont("Helvetica")); 
tableWidget->setItem(0,3,item); 

另：如果需要对所有的单元格都使用这种字体，则可以使用 tableWidget->setFont(QFont("Helvetica"));

2. 设置单元格内文字的对齐方式

这个比较简单，使用newItem.setTextAlignment()函数即可，该函数的参数为单元格内的对齐方式，和字符输入顺序是自左相右还是自右向左。
水平对齐方式有：

Constant Value Description
Qt.AlignLeft 0x0001 Aligns with the left edge.
Qt.AlignRight 0x0002 Aligns with the right edge.
Qt.AlignHCenter 0x0004 Centers horizontally in the available space.
Qt.AlignJustify 0x0008 Justifies the text in the available space.

垂直对齐方式：

Constant Value Description
Qt.AlignTop 0x0020 Aligns with the top.
Qt.AlignBottom 0x0040 Aligns with the bottom.
Qt.AlignVCenter 0x0080 Centers vertically in the available space.

如果两种都要设置，只要用 Qt.AlignHCenter | Qt.AlignVCenter 的方式即可 

3. 合并单元格效果的实现：
 

tableWidget->setSpan(0, 0, 3, 1) # 其参数为： 要改变单元格的 1行数 2列数 要合并的 3行数 4列数

 4. 设置单元格的大小

首先，可以指定某个行或者列的大小

tableWidget->setColumnWidth(3,200); 
tableWidget->setRowHeight(3,60); 

还可以将行和列的大小设为与内容相匹配

tableWidget->resizeColumnsToContents(); 
tableWidget->resizeRowsToContents(); 

5. 获得单击单元格的内容

通过实现 itemClicked (QTableWidgetItem *) 信号的槽函数，就可以获得鼠标单击到的单元格指针，进而获得其中的文字信息

connect(tableWidget,SIGNAL(itemDoubleClicked(QTreeWidgetItem*,int)),this, SLOT( getItem(QTreeWidgetItem*,int)) );

如何锁死列表头？

QTableWidget的列标题和行标题默认显示的情况下，可以拖动两个相邻列（行）之间的分割线来改变列宽（行高），如何将这个列宽（行高）锁死，设置为不可拖动的呢？

针对我所用的版本——Qt5.12，可以如下操作：

// 设置所有的列
ui->tableWidget->horizontalHeader()->setSectionResizeMode(QHeaderView::Fixed);
// 或者设置某一列，比如第一列
ui->tableWidget->horizontalHeader()->setSectionResizeMode(0,QHeaderView::Fixed);

• 首先，QTableWidget 继承自 QTableView， QTableView有一个 成员函数：

QHeaderView *QTableView::horizontalHeader() const

• 上面的函数返回的指针类型 QHeaderView 有一个成员函数：

  void QHeaderView::setSectionResizeMode(ResizeMode mode)
  /*
  Sets the constraints on how the header can be resized to those described by the given mode.
  This function was introduced in Qt 5.0.
  */
  

  从Qt的帮助文档的说明可以看出来，这个函数是5.0版本之后才有的，4.0的版本中，使用的是 

  void QHeaderView::setResizeMode(ResizeMode mode)
  

   值得一提的是：如何设置列宽自适应划分整个控件的宽度：

  ui->tableWidget->horizontalHeader()->setSectionResizeMode(QHeaderView::Stretch);
  

  设置为 stretch 模式后，每一列会自动等距离划分整个控件的宽度，并且列宽也是不能由用户拖动改变的。

 

 下面为个人模拟Windows资源管理器的一个表单。（写的比較粗糙，谅解一下） 
一、设置表单样式

table_widget->setColumnCount(4); //设置列数
  table_widget->horizontalHeader()->setDefaultSectionSize(150); 
  table_widget->horizontalHeader()->setClickable(false); //设置表头不可点击（默认点击后进行排序）

  //设置表头内容
  QStringList header;
  header<setHorizontalHeaderLabels(header);

  //设置表头字体加粗
  QFont font = this->horizontalHeader()->font();
  font.setBold(true);
  table_widget->horizontalHeader()->setFont(font);

  table_widget->horizontalHeader()->setStretchLastSection(true); //设置充满表宽度
  table_widget->verticalHeader()->setResizeMode(QHeaderView::ResizeToContents);
  table_widget->verticalHeader()->setDefaultSectionSize(10); //设置行高
  table_widget->setFrameShape(QFrame::NoFrame); //设置无边框
  table_widget->setShowGrid(false); //设置不显示格子线
  table_widget->verticalHeader()->setVisible(false); //设置垂直头不可见
  table_widget->setSelectionMode(QAbstractItemView::ExtendedSelection);  //可多选（Ctrl、Shift、  Ctrl+A都能够）
  table_widget->setSelectionBehavior(QAbstractItemView::SelectRows);  //设置选择行为时每次选择一行
  table_widget->setEditTriggers(QAbstractItemView::NoEditTriggers); //设置不可编辑
  table_widget->horizontalHeader()->resizeSection(0,150); //设置表头第一列的宽度为150
  table_widget->horizontalHeader()->setFixedHeight(25); //设置表头的高度
  table_widget->setStyleSheet("selection-background-color:lightblue;"); //设置选中背景色
  table_widget->horizontalHeader()->setStyleSheet("QHeaderView::section{background:skyblue;}"); //设置表头背景色

  //设置水平、垂直滚动栏样式
  table_widget->horizontalScrollBar()->setStyleSheet("QScrollBar{background:transparent; height:10px;}"
  "QScrollBar::handle{background:lightgray; border:2px solid transparent; border-radius:5px;}"
  "QScrollBar::handle:hover{background:gray;}"
  "QScrollBar::sub-line{background:transparent;}"
  "QScrollBar::add-line{background:transparent;}");
  table_widget->verticalScrollBar()->setStyleSheet("QScrollBar{background:transparent; width: 10px;}"
  "QScrollBar::handle{background:lightgray; border:2px solid transparent; border-radius:5px;}"
  "QScrollBar::handle:hover{background:gray;}"
  "QScrollBar::sub-line{background:transparent;}"
  "QScrollBar::add-line{background:transparent;}");