QTableWidget 应用总结

 

本文引用自：http://blog.sina.com.cn/s/blog_9c41e8ed01011mma.html

QTableWidget是QT程序中常用的显示数据表格的空间，很类似于VC、C#中的DataGrid。

它跟QTabelView的区别：

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

 1 #include <QtGui/QApplication> 
 2 #include <QTableWidget> 
 3 #include <QTableWidgetItem>
 4 
 5 int main(int argc, char *argv[]) 
 6 { 
 7 QApplication a(argc, argv); 
 8 QTableWidget *tableWidget = new QTableWidget(10,5); // 构造了一个QTableWidget的对象，并且设置为10行，5列 
 9 // 也可用下面的方法构造QTableWidget对象 
10 // QTableWidget *tableWidget = new QTableWidget; 
11 // tableWidget->setRowCount(10); //设置行数为10 
12 // tableWidget->setColumnCount(5); //设置列数为5 
13 tableWidget->setWindowTitle("QTableWidget & Item"); 
14 tableWidget->resize(350, 200); //设置表格 
15 QStringList header; 
16 header<<"Month"<<"Description"; 
17 tableWidget->setHorizontalHeaderLabels(header); 
18 tableWidget->setItem(0,0,new QTableWidgetItem("Jan")); //设置表项（行、列、项）
19 tableWidget->setItem(1,0,new QTableWidgetItem("Feb")); 
20 tableWidget->setItem(2,0,new QTableWidgetItem("Mar"));
21 
22 tableWidget->setItem(0,1,new QTableWidgetItem(QIcon("images/IED.png"), "Jan's month")); 
23 tableWidget->setItem(1,1,new QTableWidgetItem(QIcon("images/IED.png"), "Feb's month")); 
24 tableWidget->setItem(2,1,new QTableWidgetItem(QIcon("images/IED.png"), "Mar's month")); 
25 tableWidget->show();
26 
27 return a.exec(); 
28 }
29 
30  

一. 对QTableWidget本身的效果实现

 1. 将表格变为禁止编辑

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

 tableWidget->setEditTriggers(QAbstractItemView::NoEditTriggers);

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

QAbstractItemView.NoEditTriggers
0
No editing possible. 不能对表格内容进行修改

QAbstractItemView.CurrentChanged
1
Editing start whenever current item changes.任何时候都能对单元格修改

QAbstractItemView.DoubleClicked
2
Editing starts when an item is double clicked.双击单元格

QAbstractItemView.SelectedClicked
4
Editing starts when clicking on an already selected item.单击已选中的内容

QAbstractItemView.EditKeyPressed
8
Editing starts when the platform edit key has been pressed over an item.

QAbstractItemView.AnyKeyPressed
16
Editing starts when any key is pressed over an item.按下任意键就能修改

QAbstractItemView.AllEditTriggers
31
Editing starts for all above actions.以上条件全包括

 

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. 表格表头的显示与隐藏

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

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

 注意：需要 #include <QHeaderView>

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

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

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

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

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

二. 对单元格的进行设置

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

1 QTableWidgetItem *item = new QTableWidgetItem("Apple"); 
2 item->setBackgroundColor(QColor(0,60,10)); 
3 item->setTextColor(QColor(200,111,100)); 
4 item->setFont(QFont("Helvetica")); 
5 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. 设置单元格的大小

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

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

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

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

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

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

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

//将itemClicked信号与函数getItem绑定

6.表项自适应宽度

ui->tablewidget->horizontalHeader()->setResizeMode(QHeaderView::Stretch);

7.QTableWidgetItem转QString

QTableWidgetItem->data(Qt::DisplayRole)->toString()

8.将表格设定为可以根据某一列进行排序

QTableWidget允许多种数据类型的设置，理论上来说只要是QVariant能够接受的类型，都可以作为表格的内容来呈现。一般的文字信息采用setText()来设置，而如果是其他类型，比如int，则需要使用setData()来设置。注意，这两个函数都是QTableWidgetItem提供的。如果没有前导0这样的特殊需求，推荐使用setData()而不是setText(QString::number())的方式来设置数值，因为这样将导致数字类型的数据在排序时出现10比2优先的情况。另外，在重复设置数据的时候，可能表格原有的行数或列数已不满足现有的需求，那么可以使用clearContents()清空表格的所有内容（包括行数与列数）。如果有谁需要只读的表格（拒绝双击进行数据编辑），那么可以试试QTableWidgetItem的setFlags()进行操控，只要不设置可编辑标识即可。
而至于排序，只需要使用setSortingEnabled()或者sortByColumn()来开启。需要注意的是，如果在排序开启后需要增加数据，应该先关闭排序再增加数据，之后再重新开启排序，否则由于排序的干扰，数据的增加将产生问题。如果希望进行一个自定义的排序（既不是基于字母，也不是基于数字大小），那么尝试继承QTableWidgetItem并重新实现operator<()函数将起到不小的作用。
如果你的用户希望对表格进行一定程度的动态过滤，不要重新读取数据，setRowHidden()以及setColumnHidden()是个不错的选择。

9.表格表头。
表格表头可以靠horizontalHeader()以及verticalHeader()这两个成员函数获取，这两个函数来自于QTableWidget的父类QTableView，得到的返回值类型是QHeaderView*。
通过获得表头还可以对表格的拉伸进行设置。相关的函数均来自于QHeaderView：setStretchLastSection()、sectionAutoResize()、setResizeMode()。
表头的文字则可以由setHorizontalHeaderLabels()、以及setVerticalHeaderLabels()来设置。
如果你想要使用一个自定义的表头类，则可以使用setVerticalHeaderItem()、setHorizontalHeaderItem()来进行设置

10.为表格数据添加右键菜单

有时候我们想通过点击鼠标右键对表格数据进行一些其他操作，比如复制、查看详情等，我们可以按照下面的方法来实现。为了实现点击右键弹出菜单这个功能，我们必须在类studentInfo类中声明一个菜单变量popMenu和一个菜单选项变量action

声明完毕后，我们在studentInfo类的构造函数中对其进行初始化，如下：

 1 class studentInfo : public QMainWindow
 2 {
 3 …………
 4 private:
 5     Ui::studentInfo *ui;
 6     QMenu *popMenu;
 7     QAction *action;
 8 
 9 private slots:
10     void on_stuTableWidget_customContextMenuRequested(QPoint pos);
11 …………
12 };

 声明完毕后，我们在studentInfo类的构造函数中对其进行初始化，如下：

1 ui->stuTableWidget->setContextMenuPolicy(Qt::CustomContextMenu);  
2 popMenu = new QMenu(ui->stuTableWidget);  
3 action = new QAction("Copy", this); 

setContextMenuPolicy方法用来设置widget菜单项的显示方法，而CustomContextMenu是唯一与右键菜单有关的参数，因此这里我们将菜单显示方法设置为该类型。如果widget设置为CustomContextMenu时，当在数据上点击右键时就会发送customContextMenuRequested ( const QPoint & pos )信号，该信号还会捕捉到点击右键的位置，并用pos参数来存储。与此信号关联的槽函数我们定义如下：

1 void studentInfo::on_stuTableWidget_customContextMenuRequested(QPoint pos)  
2 
3  {  
4 
5      popMenu->addAction(action);  
6 
7      popMenu->exec(QCursor::pos());  
8 
9  } 

 

我们首先将菜单选项action添加到右键弹出菜单popMenu中，再通过exec方法在pos()位置显示该右键菜单，pos()返回的位置即为点击鼠标的位置。

现在，如果点击右键菜单选项并不会发生任何动作，这是因为我们并没有关联相应的槽函数。由于具体的菜单选项不同，其函数的实现也不同，这里我们只给出框架，如下：

1 void studentInfo::rightClickedOperation()  
2 
3  {  
4 
5      //do something  
6 
7  } 

 

定义好槽函数，最关键的是与相应的信号连接。对于上述两个槽函数，我们可以使用两种方法进行信号和槽的关联：在Qt Desinger模式下添加或手动进行connect关联。对于customContextMenuRequested信号，我们使用前种方法实现信号和槽的关联；对于右键菜单选项的功能实现，我们可以通过connect函数实现，如下：

1 connect(action, SIGNAL(triggered()), this, SLOT(rightClickedOperation()));