QTableWidget的用法总结

本文介绍 Qt 中 QTableWidget 控件的多种实用技巧,包括如何调整表格大小、设置编辑权限、选择行为等,并提供了丰富的代码示例。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

在使用Qt不多的日子里,已经两次用到了QTableWidget这个控件,也慢慢的习惯和喜欢上了它。再使用QTableWidget的时候,已不像刚开始使用时的迷茫。嗯嗯。现在就来总结总结我与QTableWidget相识的历程......(*^__^*) 嘻嘻……

使用时也查过不少资料,在此感谢前辈们的用心总结与分享!

  

1.QTableWidget不能在mainwindow中随主窗口的大小变化?

  解决:在表格外部添加布局。

  代码:tableWidget = new QTableWidget;

         tableWidget ->setObjectName(QString::fromUtf8("tableWidget"));

         QVBoxLayout *verticalLayout;

         verticalLayout->addWidget(tableWidget );

2.将表格变为禁止编辑:

  tableWidget->setEditTriggers(QAbstractItemView::NoEditTriggers);

  (参数含义:QAbstractItemView.NoEditTriggers--不能对表格内容进行修改

              QAbstractItemView.CurrentChanged--任何时候都能对单元格修改

              QAbstractItemView.DoubleClicked--双击单元格

              QAbstractItemView.SelectedClicked--单击已选中的内容 

              QAbstractItemView.EditKeyPressed--

              QAbstractItemView.AnyKeyPressed--按下任意键就能修改

              QAbstractItemView.AllEditTriggers--以上条件全包括)

3.设置表格为整行选择

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

  (参数含义:AbstractItemView.SelectItems--选中单个单元格

              QAbstractItemView.SelectRows--选中一行

              QAbstractItemView.SelectColumns--选中一列)

4.单个选中和多个选中的设置:

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

 (参数含义:QAbstractItemView.NoSelection--不能选择

             QAbstractItemView.SingleSelection--选中单个目标

             QAbstractItemView.MultiSelection--选中多个目标

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

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

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

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

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

  注意:需要 #include <QHeaderView>

6.对表头文字的字体、颜色进行设置 

 

  QTableWidgetItem *columnHeaderItem0 = tableWidget->horizontalHeaderItem(0); //获得水平方向表头的Item对象  

  columnHeaderItem0->setFont(QFont("Helvetica")); //设置字体  

  columnHeaderItem0->setBackgroundColor(QColor(0,60,10)); //设置单元格背景颜色  

  columnHeaderItem0->setTextColor(QColor(200,111,30)); //设置文字颜色

设置水平和垂直表头的颜色,代码如下: 
ui->tableWidget->horizontalHeader()->setStyleSheet("QHeaderView::section{background:yellow;}"); 
ui->tableWidget->verticalHeader()->setStyleSheet("QHeaderView::section{background:yellow;}"); 

ui->tableWidget->setStyleSheet("QTableCornerButton::section{background:yellow;}");

  注意:需要 #include <QHeaderView>

7.在单元格里加入控件:

   QComboBox *comBox = new QComboBox();

   comBox->addItem("Y");

   comBox->addItem("N");

   tableWidget->setCellWidget(0,2,comBox); 

8.单元格中添加图片:

  tableWidget->setItem(row, 0, new QTableWidgetItem(QIcon(":/new/images/kingdemo.ico"),tr("")));

9设置单元格字体颜色、背景颜色和字体字符:

  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"));

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

 水平对齐方式有:

 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 的方式即可

11.合并单元格:

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

12.设置单元格的大小

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

   tableWidget->setColumnWidth(3,200);

   tableWidget->setRowHeight(3,60);

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

   tableWidget->resizeColumnsToContents();

   tableWidget->resizeRowsToContents();

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

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

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

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

14.QTableWidget要调整表格行宽主要涉及以下函数

  tableWidget->horizontalHeader()->setResizeMode(QHeaderView::Stretch);//使列完全填充并平分

  tableWidget->verticalHeader()->setResizeMode(QHeaderView::Stretch);//行自适应宽度                                                                                                      

  tableWidget->resizeColumnsToContents(); //根据内容调整列宽

  tableWidget->resizeColumnToContents(int col);//根据内容自动调整给定列宽

  tableWidget->horizontalHeader()->setResizeMode//把给定列设置为给定模式

  主要模式有Stretch和Fixed

15.添加表头内容:

  方法一:

  QStringList header;

  header<<""<<tr("1")<<tr("2")<<tr("3")<<tr("4)<<tr("5");

  方法二:

  tableWidget->setHorizontalHeaderLabels(QStringList() << tr("1")<<tr("2")<<tr("3")<<tr("4)<<tr("5"));

16.清除:

  tableWidget->clear();//清除所有可见数据(包括表头),行还在

  tableWidget->clearContents();//只清除表中数据,不清除表头内容

  tableWidget->setRowCount(0);//连行也清除掉

15.一些零碎的知识点代码:

  int row = tableWidget->rowCount();//获取表格中当前总行数

  tableWidget->setRowCount(row+1);//添加一行

  tableWidget->removeRow(row);//清除已有的行列

  Int row1 = tableWidget->currentItem()->row();//当前选中行

  bool focus = tableWidget->isItemSelected(tableWidget->currentItem());//判断是否选中一行

  QString proName = tableWidget->item(row, col)->text();//获取某一格内容

  setShowGrid(true);//显示表格线

  verticalHeader()->setVisible(false);//隐藏左边垂直

  QHeaderView *headerView = horizontalHeader();

  headerView->setMovable(false);//去除表头的移动

  headerView->resizeSection(0,284);//设置第一列宽

  headerView->resizeSection(1,127);//设置第二列宽

  headerView->setResizeMode(QHeaderView::Fixed);//列表不能移动

  headerView->setClickable(false);//不响应鼠标单击

  setEditTriggers(QTableWidget::NoEditTriggers);//不能编辑

  setSelectionBehavior(QTableWidget::SelectRows);//一次选中一行

  setSelectionMode(QAbstractItemView::SingleSelection);//只能单选

  /*QScrollBar *scrollBar = horizontalScrollBar();

  scrollBar->hide();*/

  setHorizontalScrollBarPolicy(Qt::ScrollBarAlwaysOff);//去掉水平滚动条

  setVerticalScrollMode(QAbstractItemView::ScrollPerItem);//垂直滚动条按项移动

  setAutoScroll(false);//去掉自动滚动

17.排序:

  tableWidget->sortByColumn(0,Qt::AscendingOrder);//顾名思义,该函数意思是将某列按升序/降序的方式排列

<think>好的,我现在需要帮助用户了解QTableWidget的使用方法。首先,我得回忆一下自己之前学过的Qt相关知识。QTableWidgetQt中用于显示表格数据的一个控件,属于Model/View架构的一部分,但它是基于项的,比使用QTableView和自定义模型更简单一些。不过用户可能不了解这些,所以我需要从基础开始讲起。 首先,我应该介绍QTableWidget的基本概念,比如它是一个表格控件,可以用来显示和编辑二维数据。然后,可能需要分步骤说明如何创建、配置、添加数据、处理信号等。要确保结构清晰,按步骤来,这样用户容易跟随。 接下来,我需要考虑用户可能的应用场景,比如创建一个简单的表格,设置列数,添加表头,插入数据,处理单元格的点击事件等。这些都是常见的操作,应该涵盖这些内容。 还要注意提到如何设置单元格的属性和样式,比如对齐方式、字体颜色、背景色等,这可能对用户有用。另外,可能还要提到如何调整列的大小,比如设置自适应宽度或者手动调整。 然后,关于数据操作,比如获取或修改单元格的内容,遍历表格中的数据,以及如何添加自定义的控件到单元格中,比如按钮或复选框。这些高级功能可能会帮助用户更灵活地使用表格。 信号和槽的部分也很重要,用户可能需要响应单元格的变化,比如内容修改、选中单元格等事件,所以需要给出示例说明如何连接这些信号到槽函数。 还要注意潜在的问题,比如性能问题,当数据量大时,QTableWidget可能不如使用模型/视图高效,这时候可能需要提及QTableView和自定义模型的优势,但用户的问题是QTableWidget,所以可以稍微提到这点,但重点还是放在QTableWidget上。 另外,需要确保示例代码正确,符合PyQt或PySide的语法,但用户没有明确说明使用哪个,可能需要统一用PyQt的示例,或者注明两者类似。同时,按照用户的要求,内公式用$...$,独立公式用$$...$$,不过在这个问题中可能数学公式较少,但如果有涉及到计算或示例中的数值,可能需要使用,比如设置列数的例子。 需要检查是否有遗漏的常用功能,比如合并单元格、排序、右键菜单等,这些可能对用户有帮助,但根据时间限制,可能需要简要提及,或者放在高级用法中。 最后,组织内容时,要分步骤,如创建、基本设置、数据操作、信号处理、样式调整等,每个部分用标题分开,示例代码用代码块表示,并加上必要的注释。同时,提醒用户注意内存管理和性能问题,避免在处理大数据时出现卡顿。 总结一下,回答的结构应该是: 1. 简介 2. 基本使用步骤(创建、列设置、表头) 3. 数据操作(插入、获取、修改) 4. 单元格属性和样式 5. 信号与槽 6. 高级功能(自定义控件、排序) 7. 注意事项(性能等) 这样用户能逐步学习,从基础到高级,结构清晰。现在需要把这些内容用中文组织好,确保每个部分都有示例代码,并正确遵循LaTeX格式的要求,虽然在这个问题中可能用到的数学公式不多,但如果有的话要正确应用。例如,在说明数或列数的时候,可能用$m \times n$这样的表示,但需要按照用户的系统指令处理。</think>### QTableWidget 使用方法详解 QTableWidgetQt 中用于显示和编辑二维表格数据的控件,适合中小规模数据场景。以下是详细使用步骤: --- #### 一、创建与基本配置 ```python from PyQt5.QtWidgets import QApplication, QTableWidget, QTableWidgetItem, QHeaderView # 1. 创建表格控件 table = QTableWidget() table.setRowCount(3) # 设置数,例如:$3 \times 4$ 表格 table.setColumnCount(4) # 2. 设置表头 table.setHorizontalHeaderLabels(["姓名", "年龄", "性别", "职业"]) table.setVerticalHeaderLabels(["1", "2", "3"]) # 3. 自适应列宽(可选) table.horizontalHeader().setSectionResizeMode(QHeaderView.Stretch) ``` --- #### 二、数据操作 1. **插入数据** ```python # 直接设置单元格内容 table.setItem(0, 0, QTableWidgetItem("张三")) table.setItem(0, 1, QTableWidgetItem("25")) # 批量填充 data = [ ["李四", "30", "男", "工程师"], ["王五", "28", "女", "设计师"] ] for row_idx, row_data in enumerate(data, start=1): # 从第2开始 for col_idx, cell_data in enumerate(row_data): table.setItem(row_idx, col_idx, QTableWidgetItem(cell_data)) ``` 2. **获取/修改数据** ```python item = table.item(0, 0) # 获取单元格对象 print(item.text()) # 输出:张三 table.item(0, 1).setText("26") # 修改年龄为26 ``` --- #### 三、单元格属性与样式 ```python # 1. 对齐方式 item = QTableWidgetItem("居中文本") item.setTextAlignment(0x0004 | 0x0080) # 水平居中 + 垂直居中 # 2. 字体颜色/背景色 item.setForeground(QColor(255, 0, 0)) # 红色字体 item.setBackground(QColor(200, 200, 200)) # 灰色背景 # 3. 禁止编辑 table.setEditTriggers(QTableWidget.NoEditTriggers) ``` --- #### 四、信号与事件处理 ```python # 1. 单元格点击事件 table.cellClicked.connect(lambda row, col: print(f"点击:({row}, {col})")) # 2. 内容修改事件 table.cellChanged.connect(lambda row, col: print(f"修改内容为:{table.item(row, col).text()}")) ``` --- #### 五、高级功能 1. **嵌入控件** ```python from PyQt5.QtWidgets import QPushButton # 在单元格中添加按钮 btn = QPushButton("删除") btn.clicked.connect(lambda: table.removeRow(0)) # 点击删除第一 table.setCellWidget(0, 3, btn) ``` 2. **排序与搜索** ```python # 启用排序 table.setSortingEnabled(True) # 按列搜索(示例:查找年龄>25的) for row in range(table.rowCount()): age = int(table.item(row, 1).text()) table.setRowHidden(row, age <= 25) ``` --- #### 六、注意事项 1. **性能问题**:数据量超过 1000 时,建议改用 `QTableView + QStandardItemModel`。 2. **内存管理**:避免频繁调用 `setRowCount()` 和 `setColumnCount()`。 3. **线程安全**:禁止在多线程中直接操作表格,需通过信号槽机制更新。 --- 通过上述步骤,您可快速实现表格展示、交互和样式定制。如需更复杂的模型操作(如数据库绑定),建议学习 Model/View 架构中的 `QTableView`。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值