PyQt5 使用自定义ToolTip解决QTableWidget数据显示不全问题

待我称王封你为后i 2023-07-24 08:56 247阅读 0赞

目录

问题描述

自定义QTableWidget

代码解释

实例演示代码

实现效果

总结

参考资料

补充更新

问题描述

最近在使用PyQT5做一个项目，用到最多的控件是QTableWidget,使用很方便,但是也存在很多问题，比如下面这种：

watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2RhaW1hc2hpcmVu_size_16_color_FFFFFF_t_70

数据太长，使用QTableWidget默认的列宽分配会导致显示不全，数据以”XXX…”的形式呈现，很不利于用户阅读。一个可能的解决办法是采用用户可以手动调整的方式来显示数据。效果如下图:

图像无法显示

使用的代码是这一句:

  1. TableWidget.horizontalHeader().setSectionResizeMode(QHeaderView.Interactive)  # 列宽手动调整

可以看到，貌似问题解决了，可是界面已经完全变形了，实在让人觉得不愉悦，那么有什么更好的解决方案吗？

watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2RhaW1hc2hpcmVu_size_16_color_FFFFFF_t_70 1

只见柯南君思考片刻后，抬了抬那光芒四射的眼镜，说道：

watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2RhaW1hc2hpcmVu_size_16_color_FFFFFF_t_70 2

hahaha看到这，要是再不把代码贴上来可能会被打了，那就话不多说，show me the code!

自定义QTableWidget

  1. # -*- coding: utf-8 -*-
  2. """
  3. @author:daimashiren
  4. @time:2020-04-15
  5. """
  6. from PyQt5.QtWidgets import *
  7. from PyQt5.QtCore import *
  8. from PyQt5.QtGui import *
  9. import traceback
  10. from functools import partial
  12. # 自定义的QTableWidget,使用ToolTip提示用户当前单元格内的详细内容
  13. class MyTableWidget(QTableWidget):
  14.     update_table_tooltip_signal = pyqtSignal(object)
  16.     def __init__(self, row, col):
  17.         super(MyTableWidget, self).__init__()
  18.         self.setRowCount(row)
  19.         self.setColumnCount(col)
  20.         self.ini_table()
  22.     def ini_table(self):
  23.         """---------初始化表格的常用选项(按需修改)------------"""
  24.         QTableWidget.resizeColumnsToContents(self)
  25.         QTableWidget.resizeRowsToContents(self)
  26.         self.setSelectionMode(QAbstractItemView.NoSelection)
  27.         self.horizontalHeader().setSectionResizeMode(QHeaderView.Stretch)  # 列宽自动分配
  28.         self.verticalHeader().setSectionResizeMode(QHeaderView.Stretch)  # 行高自动分配
  29.         # self.verticalHeader().stretchLastSection()                         #自动拓展最后一行适应表格高度
  30.         self.horizontalHeader().setVisible(False)
  31.         self.verticalHeader().setVisible(False)
  32.         self.setEditTriggers(QAbstractItemView.NoEditTriggers)
  34.         """------------关键代码--------------"""
  35.         self.vertical_scrollbar = QScrollBar()
  36.         self.horizon_scrollbar = QScrollBar()
  37.         self.vertical_scrollbar.valueChanged.connect(partial(self.scollbar_change_slot, "vertical"))
  38.         self.horizon_scrollbar.valueChanged.connect(partial(self.scollbar_change_slot, "horizon"))
  39.         self.setVerticalScrollBar(self.vertical_scrollbar)
  40.         self.setHorizontalScrollBar(self.horizon_scrollbar)
  41.         self.init_row = 0
  42.         self.init_col = 0
  43.         self.tool_tip = ""
  44.         self.update_table_tooltip_signal.connect(self.update_table_tooltip_slot)
  45.         self.title_row_height = 0
  47.     # 设置表格列标题
  48.     def set_horizon_title(self, title_list):
  49.         self.horizontalHeader().setDefaultAlignment(Qt.AlignLeft)
  50.         self.horizontalHeader().setVisible(True)
  51.         col = 0
  52.         for item in title_list:
  53.             item = QTableWidgetItem(str(item))
  54.             item.setSizeHint(QSize(200, 45))  # 这里默认设置了列标题的宽和高分别为200、45,可根据需要修改
  55.             self.setHorizontalHeaderItem(col, item)
  56.             col += 1
  58.         self.title_row_height = 45  # (关键值)这里的值设置为列标题高
  60.     # 为TableWidget安装事件过滤器
  61.     def install_eventFilter(self):
  62.         self.installEventFilter(self)
  63.         self.setMouseTracking(True)
  65.     #改变滚动条时重置当前页面的初始行和列
  66.     def scollbar_change_slot(self, type):
  67.         if type == "vertical":
  68.             value = self.verticalScrollBar().value()
  69.             self.init_row = value
  70.             # print("垂直滚动条当前的值为:",value)
  71.             # print("当前页面的起始行为:",self.init_row)
  72.         else:
  73.             value = self.horizontalScrollBar().value()
  74.             self.init_col = value
  75.             # print("水平滚动条当前的值为:",value)
  76.             # print("当前页面的起始列为:",self.init_col)
  78.     # 通过计算坐标确定当前位置所属单元格
  79.     def update_table_tooltip_slot(self, posit):
  80.         self.tool_tip = ""
  81.         self.mouse_x = posit.x()
  82.         self.mouse_y = posit.y()
  83.         self.row_height = self.title_row_height  # 累计行高,初始值为列标题行高
  84.         for r in range(self.rowCount()):
  85.             current_row_height = self.rowHeight(r)
  86.             self.col_width = 0  # 累计列宽
  87.             if self.row_height <= self.mouse_y <= self.row_height + current_row_height:
  88.                 for c in range(self.columnCount()):
  89.                     current_col_width = self.columnWidth(c)
  90.                     if self.col_width <= self.mouse_x <= self.col_width + current_col_width:
  91.                         r = self.init_row + r
  92.                         c = self.init_col + c
  93.                         print("鼠标当前所在的行和列为:({},{})".format(r, c))
  94.                         item = self.item(r, c)
  95.                         if item != None:
  96.                             self.tool_tip = item.text()
  97.                         else:
  98.                             self.tool_tip = ""
  99.                         return self.tool_tip
  100.                     else:
  101.                         self.col_width = self.col_width + current_col_width
  102.             else:
  103.                 if self.mouse_y < self.row_height:
  104.                     break
  105.                 else:
  106.                     self.row_height = self.row_height + current_row_height
  108.     # 事件过滤器
  109.     def eventFilter(self, object, event):
  110.         try:
  111.             if event.type() == QEvent.ToolTip:
  112.                 self.setCursor(Qt.ArrowCursor)
  113.                 print("当前鼠标位置为:", event.pos())
  114.                 self.update_table_tooltip_signal.emit(event.pos())
  115.                 # 设置提示气泡显示范围矩形框,当鼠标离开该区域则ToolTip消失
  116.                 rect = QRect(self.mouse_x, self.mouse_y, 30, 10)  # QRect(x,y,width,height)
  117.                 # 设置QSS样式
  118.                 self.setStyleSheet(
  119.                     """QToolTip{border:10px;
  120.                        border-top-left-radius:5px;
  121.                        border-top-right-radius:5px;
  122.                        border-bottom-left-radius:5px;
  123.                        border-bottom-right-radius:5px;
  124.                        background:#4F4F4F;
  125.                        color:#00BFFF;
  126.                        font-size:18px;
  127.                        font-family:"微软雅黑";
  128.                     }""")
  129.                 QApplication.processEvents()
  130.                 # 在指定位置展示ToolTip
  131.                 QToolTip.showText(QCursor.pos(), self.tool_tip, self, rect, 1500)
  133.                 """
  134.                 showText(QPoint, str, QWidget, QRect, int)
  135.                 #############参数详解###########
  136.                 #QPoint指定tooptip显示的绝对坐标,QCursor.pos()返回当前鼠标所在位置
  137.                 #str为设定的tooptip
  138.                 #QWidget为要展示tooltip的控件
  139.                 #QRect指定tooltip显示的矩形框范围,当鼠标移出该范围,tooltip隐藏,使用该参数必须指定Qwidget!
  140.                 #int用于指定tooltip显示的时长(毫秒)
  141.                 """
  142.             return QWidget.eventFilter(self, object, event)
  143.         except Exception as e:
  144.             traceback.print_exc()

代码里的关键点我已经做了批注了，这里再总结一下吧！

代码解释

  • 创建一个eventFilter，捕获当前所有事件并从中筛选出tooltip事件和要显示tooltip的控件QTableWidget.
  • 为QTableWidget安装上述eventFilter并设置自动捕获鼠标.``

self.TableWidget.installEventFilter(self)

self.TableWidget.setMouseTracking(True)

  • 编写一个判断鼠标当前位于哪个单元格的函数并且更新toop_tip为当前单元格内的内容.
  • 最后在EventFilter里的Tooptip event下使用QToolTip.showtext()方法展示实时更新的toop_tip即可.

实例演示代码

  1. #测试自定义TableWidget
  2. class test_table_win(QWidget):
  3.     def __init__(self):
  4.         super(test_table_win, self).__init__(parent=None)
  5.         self.init_ui()
  7.     def init_ui(self):
  8.         self.setWindowTitle("测试ToolTip")
  9.         self.setGeometry(500,400,500,300)
  10.         self.main_layout = QVBoxLayout()
  11.         self.main_layout.setContentsMargins(0,0,0,0)
  12.         self.setLayout(self.main_layout)
  14.         """调用自定义TableWidget控件"""
  15.         self.TableWidget = MyTableWidget(5, 3)
  16.         self.TableWidget.resize(self.width(),225)
  17.         self.TableWidget.verticalHeader().stretchLastSection()
  18.         title_list = ["省份","省会","旅游景点"]
  19.         self.TableWidget.set_horizon_title(title_list)
  20.         """为TableWidget安装事件过滤器(关键)"""
  21.         self.TableWidget.install_eventFilter()
  23.         self.main_layout.addWidget(self.TableWidget)
  25.     def set_table_content(self,list1,list2,list3):
  26.         row = 0
  27.         for item1,item2,item3 in zip(list1,list2,list3):
  28.             self.TableWidget.setItem(row,0,QTableWidgetItem(item1))
  29.             self.TableWidget.setItem(row,1,QTableWidgetItem(item2))
  30.             self.TableWidget.setItem(row,2,QTableWidgetItem(item3))
  31.             row = row+1
  33. if __name__ == "__main__":
  34.     import sys
  35.     province_list = ["四川", "广西", "贵州", "云南", "广东"]
  36.     city_list = ["成都", "南宁", "贵阳", "昆明", "广州"]
  37.     site_list = ["九寨沟、黄龙、峨眉山、青城山、乐山大佛、都江堰",
  38.                  "桂林漓江、钦州三娘湾、北海银滩、大新德天瀑布、百色乐业大石围天坑群",
  39.                  "黄果树瀑布、赤水丹霞、织金洞、红枫湖、梵净山、遵义会址",
  40.                  "怒江、九龙瀑布群、三江并流、西双版纳热带植物园、罗平螺丝田、玉龙雪山、丽江古城、香格里拉",
  41.                  "韶关丹霞山、广州塔、广州白云山、江门开坪碉楼、南澳岛、罗浮山"]
  42.     app = QApplication(sys.argv)
  43.     test_table = test_table_win()
  44.     test_table.set_table_content(province_list,city_list,site_list)
  45.     test_table.show()
  46.     sys.exit(app.exec_())

实现效果

实现效果如图所示,有点类似JS做出来的悬浮窗的感觉。当鼠标移动到QTableWidget的某一单元格上时，会以ToolTip悬浮窗的形式展示该单元格内的全部内容，这样就不用担心显示不全的问题啦！

图片无法显示

总结

  1. 自定义一个QTableWidget控件(上文中的MyTableWidget)
  2. 实例化MyTableWidget,调用MyTableWidget的 install_eventFilter()方法为控件安装事件过滤器

码字不易，喜欢请点赞哟！

参考资料

https://doc.qt.io/qt-5/qtooltip.html

https://doc.qt.io/qt-5/qtablewidget.html

https://blog.csdn.net/zgrjkflmkyc/article/details/41381651

https://stackoverflow.com/questions/7829829/pyqt4-mousemove-event-without-mousepress

补充更新

官方文档真的是个好东西,最近又发现了一个更简单的办法，分享给大家，代码量可以减少一半！！！

  1. """
  2. @author: daimashiren
  3. @time:   2020/05/22
  4. """
  5. # -*- coding: utf-8 -*-
  6. from PyQt5.QtWidgets import  QTableWidget,QAbstractItemView
  7. from PyQt5.QtWidgets import  QApplication,QWidget,QToolTip
  8. from PyQt5.QtWidgets import QHeaderView
  9. from PyQt5.QtCore import pyqtSignal,QEvent,Qt,QRect
  10. from PyQt5.QtGui import QCursor
  11. import  traceback
  13. #自定义的自带单元格提示功能的QTableWidget
  14. class MyTableWidget(QTableWidget):
  15.     update_table_tooltip_signal = pyqtSignal(object)
  16.     def __init__(self,row,col):
  17.         super(MyTableWidget, self).__init__()
  18.         self.setRowCount(row)
  19.         self.setColumnCount(col)
  20.         self.ini_table()
  22.     def ini_table(self):
  23.         """---------初始化表格的常用选项(按需修改)------------"""
  24.         QTableWidget.resizeColumnsToContents(self)
  25.         QTableWidget.resizeRowsToContents(self)
  26.         self.horizontalHeader().setSectionResizeMode(QHeaderView.Stretch)  # 列宽自动分配
  27.         self.horizontalHeader().setVisible(True)
  28.         self.verticalHeader().setVisible(False)
  29.         self.setEditTriggers(QAbstractItemView.NoEditTriggers)
  30.         """------------关键代码--------------"""
  31.         self.installEventFilter(self)
  32.         self.setMouseTracking(True)
  33.         #绑定槽函数
  34.         self.itemEntered.connect(self.enter_item_slot)
  36.     #获得鼠标进入的单元格对应的QTableWidgetItem对象
  37.     def enter_item_slot(self, item):
  38.         self.tool_tip = item.text()
  39.         print("self.tool_tip:",self.tool_tip)
  41.     def eventFilter(self, object, event):
  42.         try:
  43.             if event.type() == QEvent.ToolTip and self.tool_tip!= None:
  44.                 print("self.tool_tip:",self.tool_tip)
  45.                 self.setCursor(Qt.ArrowCursor)
  46.                 print("当前鼠标位置为:", event.pos())
  47.                 # 设置提示气泡显示范围矩形框,当鼠标离开该区域则ToolTip消失
  48.                 rect = QRect(event.pos().x(), event.pos().y(), 30, 10)        # QRect(x,y,width,height)
  49.                 # 设置QSS样式
  50.                 self.setStyleSheet(
  51.                     """QToolTip{border:10px;
  52.                        border-top-left-radius:5px;
  53.                        border-top-right-radius:5px;
  54.                        border-bottom-left-radius:5px;
  55.                        border-bottom-right-radius:5px;
  56.                        background:#4F4F4F;
  57.                        color:#00BFFF;
  58.                        font-size:18px;
  59.                        font-family:"微软雅黑";
  60.                     }""")
  61.                 QApplication.processEvents()
  62.                 #在指定位置展示ToolTip
  63.                 QToolTip.showText(QCursor.pos(), self.tool_tip, self, rect, 1500)
  64.                 self.tool_tip = None          #重设tool_tip
  65.                 """
  66.                 showText(QPoint, str, QWidget, QRect, int)
  67.                 #############参数详解###########
  68.                 #QPoint指定tooptip显示的绝对坐标,QCursor.pos()返回当前鼠标所在位置
  69.                 #str为设定的tooptip
  70.                 #QWidget为要展示tooltip的控件
  71.                 #QRect指定tooltip显示的矩形框范围,当鼠标移出该范围,tooltip隐藏,使用该参数必须指定Qwidget!
  72.                 #int用于指定tooltip显示的时长(毫秒)
  73.                 """
  74.             return QWidget.eventFilter(self, object, event)
  75.         except Exception as e:
  76.             traceback.print_exc()

上面这个自带单元格提示功能的TableWidget的使用方法和原装的QTableWidget是一样的,只需要实例化就可以了，功能一样强大!感谢官方文档，害，早些看到就好了，颇省事！Qt官方文档的描述如下:

watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2RhaW1hc2hpcmVu_size_16_color_FFFFFF_t_70 3

大意就是返回鼠标进入的单元格对应的QTableWidgetItem，我们可以利用这个内置信号获得所需的ToolTip，只需要几行代码就可以搞定。

  1. #绑定槽函数
  2.     self.itemEntered.connect(self.enter_item_slot)
  4.     #获得鼠标进入的单元格对应的QTableWidgetItem对象
  5.     def enter_item_slot(self, item):
  6.         self.tool_tip = item.text()
  7.         print("self.tool_tip:",self.tool_tip)

简单省事儿，之前想的实在太复杂了（捂脸哭）。。。以后一定把官方文档研究透彻再搞代码,吸取教训了。

官方文档链接:

https://doc.qt.io/qt-5/qtablewidget.html#itemEntered

发表评论

表情：
评论列表 （有 0 条评论，247人围观）

还没有评论，来说两句吧...

相关阅读