PySide2中QTextBrowser悬停文件路径显示缩略图实现咨询

核心关键词确认 #

你的需求核心不是单一的tooltip，而是QTextBrowser URL悬停监测 + 自定义悬浮缩略图展示——如果用tooltip承载缩略图，它只是实现载体之一，核心是拦截URL悬停事件并生成对应文件的缩略图。

具体实现步骤 #

1. 开启拖拽支持与事件监测 #

先给QTextBrowser启用拖拽，并安装事件过滤器捕获鼠标事件：

self.text_browser.setAcceptDrops(True)
self.text_browser.viewport().installEventFilter(self)

2. 处理拖拽与悬停事件 #

重写eventFilter方法，完成文件拖拽插入、URL悬停检测：

import os
from PyQt5 import QtCore, QtGui, QtWidgets

class YourWidget(QtWidgets.QWidget):
    def __init__(self):
        super().__init__()
        self.text_browser = QtWidgets.QTextBrowser(self)
        # 初始化设置
        self.text_browser.setAcceptDrops(True)
        self.text_browser.viewport().installEventFilter(self)

    def eventFilter(self, obj, event):
        if obj != self.text_browser.viewport():
            return super().eventFilter(obj, event)

        # 处理文件拖拽释放
        if event.type() == QtCore.QEvent.Drop:
            for url in event.mimeData().urls():
                if url.isLocalFile():
                    file_path = url.toLocalFile()
                    # 插入带URL的HTML文本
                    html = f'<a href="file:///{file_path}">{os.path.basename(file_path)}</a><br>'
                    self.text_browser.insertHtml(html)
            return True

        # 处理鼠标悬停，检测URL
        elif event.type() == QtCore.QEvent.MouseMove:
            pos = event.pos()
            url_str = self.text_browser.anchorAt(pos)
            if url_str.startswith('file:///'):
                file_path = url_str[8:]  # 剥离file:///前缀
                self.show_thumbnail(file_path, pos)
            else:
                self.hide_thumbnail()
        return super().eventFilter(obj, event)

3. 生成并展示缩略图 #

用QToolTip承载缩略图（简单快捷），也可以自定义悬浮窗口：

def show_thumbnail(self, file_path, pos):
        # 图片文件直接生成缩略图
        if file_path.lower().endswith(('.png', '.jpg', '.jpeg', '.bmp', '.gif')):
            pixmap = QtGui.QPixmap(file_path).scaled(200, 200, QtCore.Qt.KeepAspectRatio, QtCore.Qt.SmoothTransformation)
            # 将pixmap转为base64嵌入HTML tooltip
            buffer = QtCore.QBuffer()
            buffer.open(QtCore.QIODevice.WriteOnly)
            pixmap.save(buffer, 'PNG')
            img_base64 = buffer.data().toBase64().data().decode()
            tooltip_html = f'<img src="data:image/png;base64,{img_base64}" style="border:1px solid #ccc;">'
            # 调整tooltip位置到鼠标右侧
            global_pos = self.text_browser.mapToGlobal(pos) + QtCore.QPoint(20, 0)
            QtGui.QToolTip.showText(global_pos, tooltip_html, self.text_browser)
        else:
            # 非图片文件显示系统图标
            icon_provider = QtGui.QFileIconProvider()
            icon = icon_provider.icon(QtCore.QFileInfo(file_path))
            pixmap = icon.pixmap(200, 200)
            buffer = QtCore.QBuffer()
            buffer.open(QtCore.QIODevice.WriteOnly)
            pixmap.save(buffer, 'PNG')
            img_base64 = buffer.data().toBase64().data().decode()
            tooltip_html = f'<img src="data:image/png;base64,{img_base64}" style="border:1px solid #ccc;">'
            global_pos = self.text_browser.mapToGlobal(pos) + QtCore.QPoint(20, 0)
            QtGui.QToolTip.showText(global_pos, tooltip_html, self.text_browser)

    def hide_thumbnail(self):
        QtGui.QToolTip.hideText()

4. 优化细节 #

• 若anchorAt检测URL不准确，可替换为cursorForPosition选中当前单词判断：

  cursor = self.text_browser.cursorForPosition(pos)
  cursor.select(QtGui.QTextCursor.WordUnderCursor)
  url_str = cursor.selectedText()
  

• 非图片文件的系统级缩略图（如文档、视频），可调用平台API：
  • Windows：使用ctypes调用SHGetFileInfo
  • Linux：调用gio命令获取缩略图路径
  • macOS：通过QLibrary调用QuickLook接口

内容的提问来源于stack exchange，提问作者Good-boy