QTableWidget理论总结
-
- 1. 概述
- 2. QTableWidgetItem 概述
- 3. 表头设置
- 4. 常用功能
- 5. 常用信号
- 6. 槽函数
- 7. 外观
1. 概述
QTableWidget 是 Qt 提供的一个简单方便、标准的表格显示类。QTableWidget 中的 单元格数据 由 QTableWidgetItem 显示如果 想要一个使用你自己定义modle 的表，你应该使用 QTableView 。
QTableWidget 可以使用所需的行数和列数来构造一个对象：
或者，可以在没有给定大小的情况下构造表，并在以后调整大小：
tableWidget = new QTableWidget(this);
tableWidget->setRowCount(10);
tableWidget->setColumnCount(5);
但是记得一定要设置好列数或者函数。没设置行列大小的时候，去 setItem() 的时候会出问题的，设置不成功的。
QTableWidgetItem 在表外部创建（没有父小部件），并使用 setItem() 插入到表中：
QTableWidgetItem *newItem = new QTableWidgetItem(tr("%1").arg(
(row+1)*(column+1)));
tableWidget->setItem(row, column, newItem);
如果要在QTableWidget中启用排序功能，请在用QTableWidgetItem 填充表格后再启用排序功能，否则排序可能会干扰顺序。
表格的结构如下
2. QTableWidgetItem 概述
Qt 提供的像列表、表格之类的标准 Item 类的功能基本都一致的。每一个单元格内容其实就是 一个 Item。每个Item可以包含多条信息，并将适当地显示它们。
其实知道 QTableWidgetItem 能 显示并编辑文本、还能check 就够用了。
QTableWidgetItem 通常用于显示 文本 text() 和 图标 icon () 。这些是使用 setText() 和 setIcon() 函数设置的。文本的外观可以使用 setFont() 、setForeground() 和 setBackground() 进行自定义。列表项中的文本可以使用 setTextAlignment() 函数对齐。工具提示、状态提示和“这是什么？”帮助可以添加到使用 setToolTip() 、setStatusTip() 和 setWhatsThis() 的列表项中。
默认情况下，Item是 enabled, selectable, checkable的，并且配置 成可拖放、可编辑、可点击 check 的。这都是属于Item 的标志。
每个Item的标志可以通过使用适当的值调用setFlags() 来更改（参见Qt::ItemFlags）。可以使用 setCheckState() 函数检查、取消选中和部分检查可检查的Item。相应的 checkState() 函数指示Item的当前检查状态。
常用的标志像下面
| 标志名 | 含义 |
|---|---|
| Qt::NoItemFlags | 完全禁用 |
| Qt::ItemIsSelectable | item可被选中 |
| Qt::ItemIsEditable | item可被编辑 |
| Qt::ItemIsDragEnabled | item可被 拖住 |
| Qt::ItemIsDropEnabled | item可被 放置 |
| Qt::ItemIsUserCheckable | item可用 check 的类似 QCheckBox |
| Qt::ItemIsEnabled | item可用不 |
isHidden() 函数可用于确定Item是否隐藏。要隐藏Item，请使用 setHidden() 。
3. 表头设置
表头的话就像上图一样
QTableWidget 可以同时提供水平和垂直标题。创建标头的最简单方法是向 setHorizontalHeaderLabels() 和 setVerticalHeaderLabels() 函数提供字符串列表。这些将为表的列和行提供简单的文本标题。
也可以从通常在表外部构造的现有表项创建更复杂的标头。
例如，我们可以构造一个带有图标和对齐文本的表格项，并将其用作特定列的标题：
QTableWidgetItem *cubesHeaderItem = new QTableWidgetItem(tr("Cubes"));
cubesHeaderItem->setIcon(QIcon(QPixmap(":/Images/cubed.png")));
cubesHeaderItem->setTextAlignment(Qt::AlignVCenter);
一般获取 表头的话 通过 QTableView 的函数
QHeaderView * horizontalHeader() const ：获取水平表头
QHeaderView * verticalHeader() const ：获取垂直表头
在 控制外观这些 比如这个表格内容填充整个窗口呀，列宽，列高都是通过设置 QHeaderView 的某些属性来完成的。
4. 常用功能
表中的行数可以用 rowCount() 找到，列数可以用columnCount() 找到。可以使用 clear() 函数清除该表。
- 可以通过 row () 和 column() 获取到某一个 QTableWidgetItem 的位置、也可以通过 item() 来定位到具体的Item
- currentColumn() 、currentItem() 、currentRow() 获取当前选择的 单个 Item 的位置
- findItems() 查找满足条件的 QTableWidgetItem
5. 常用信号
很多信号其实你看一眼就大致知道是干嘛的了。
| 信号名 | 含义 |
|---|---|
| cellActivated(int row, int column) | 就是具体哪一个单元格被激活，激活可能是单击、双击、 |
| cellChanged(int row, int column) | 就是具体哪一个单元格内容改变了，可能是文字、图标内容改变了 |
| cellClicked(int row, int column) | 就是具体哪一个单元格被单击了 |
| cellDoubleClicked(int row, int column) | 就是具体哪一个单元格被双击了 |
| cellEntered(int row, int column) | |
| cellPressed(int row, int column) | 就是具体哪一个单元格被按下了 |
| currentCellChanged(int currentRow, int currentColumn, int previousRow, int previousColumn) | 发生了新的单元格被选择了 |
| currentItemChanged(QTableWidgetItem *current, QTableWidgetItem *previous) | 发生了新的单元格被选择了 |
| itemActivated(QTableWidgetItem *item) | 就是具体哪一个item 被激活，和 cellActivated 一样 |
| itemChanged(QTableWidgetItem *item) | 和 cellChanged一样 |
| itemClicked(QTableWidgetItem *item) | 和 cellClicked一样 |
| itemDoubleClicked(QTableWidgetItem *item) | 和 cellDoubleClicked一样 |
| itemEntered(QTableWidgetItem *item) | 和 cellEntered 一样 |
| itemPressed(QTableWidgetItem *item) | 和 cellPressed一样 |
| itemSelectionChanged() | 其实就是发生了新的选择，可能是某一个区域被选择了 |
6. 槽函数
| 信号名 | 含义 |
|---|---|
| clear() | 移除所有单元格包括表头 |
| clearContents() | 只移除所有单元格、不移除表头 |
| insertColumn(int column) | 插入一个指定位置的空白列 |
| insertRow(int row) | 插入一个指定位置的空白行 |
| removeColumn(int column) | 移除某一列 及其 在该列的单元格 |
| removeRow(int row) | 移除某一行 及其 在该列的单元格 |
| scrollToItem() | 把表格滚动到某一个单元格处。 |
7. 外观
在外观的方面主要有两个控制源 一、QTableView ; 二、QHeaderView
-
QTableView
在 QTableView 的设置就 5个
| 外观属性名 | 含义 |
|---|---|
| cornerButtonEnabled | 最左上脚按钮是否可用 |
| gridStyle | 网格的样式 |
| showGrid | 是否展示网格 |
| sortingEnabled | 是否可排序 |
| wordWrap | 就是单元格内容太长、换不换行 |
-
QHeaderView
其实就是控制 标签的长宽，因为每个单元格都是由 horizontalHeader、verticalHeader 的长宽来限制出大小嘛。
这个
| 外观属性名 | 含义 |
|---|---|
| defaultAlignment | 就是 表头的 文字对齐方式 |
| defaultSectionSize | 单元格的默认长 |
| firstSectionMovable | 第一个 表头可以移动不 |
| highlightSections | 是否高亮 显示 被选中的表头 |
| maximumSectionSize | 单元格的默认长 |
| minimumSectionSize | 单元格的默认长 |
| showSortIndicator | 是否展示 排序的箭头 |
| stretchLastSection | 就是把最后一个表头占满整个表格控件 |
还有就是 setSectionResizeMode() 就设置单元格是否自动把表格占满，很多模式可以选择的，我一般用的 QHeaderView::Stretch ：QHeaderView将自动调整该部分的大小以填充可用空间。用户无法更改大小，也无法以编程方式更改大小。就交给 QHeaderView 来调整大小。