PySide6应用如何在系统托盘图标旁显示并动态更新短文本

PySide6的QSystemTrayIcon本身没有直接提供在图标旁显示文本的API，但可以通过以下两种方案实现需求：

方案一：跨平台通用——绘制带文本的自定义图标 #

这种方法通过在基础图标上绘制文本，生成新的图标并设置给托盘，支持所有操作系统。动态更新时只需重新生成图标即可。

代码示例 #

from PySide6.QtWidgets import QApplication, QSystemTrayIcon, QMenu
from PySide6.QtGui import QPixmap, QPainter, QFont, QColor, QIcon
from PySide6.QtCore import Qt, QTimer
import sys

def create_tray_icon_with_text(base_icon_path, text):
    # 加载基础图标
    base_pixmap = QPixmap(base_icon_path)
    # 创建与基础图标尺寸一致的透明画布
    pixmap = QPixmap(base_pixmap.size())
    pixmap.fill(Qt.transparent)

    painter = QPainter(pixmap)
    # 绘制原始图标
    painter.drawPixmap(0, 0, base_pixmap)
    # 配置文本样式
    font = QFont()
    font.setBold(True)
    font.setPointSize(10)  # 根据图标大小调整字号
    painter.setFont(font)
    painter.setPen(QColor("white"))  # 白色文本适配深色图标，可按需修改

    # 计算文本位置（示例：右上角偏移2像素）
    text_bounds = painter.fontMetrics().boundingRect(text)
    x_pos = base_pixmap.width() - text_bounds.width() - 2
    y_pos = 2
    painter.drawText(x_pos, y_pos + text_bounds.height(), text)
    
    painter.end()
    return QIcon(pixmap)

if __name__ == "__main__":
    app = QApplication(sys.argv)
    app.setQuitOnLastWindowClosed(False)

    # 创建托盘右键菜单
    tray_menu = QMenu()
    quit_action = tray_menu.addAction("退出")
    quit_action.triggered.connect(app.quit)

    # 初始化托盘图标
    tray_icon = QSystemTrayIcon()
    tray_icon.setContextMenu(tray_menu)

    # 设置初始带文本的图标
    current_text = "25℃"
    tray_icon.setIcon(create_tray_icon_with_text("your_icon.png", current_text))
    tray_icon.show()

    # 模拟动态更新文本（实际场景可替换为业务逻辑触发）
    def update_tray_text(new_text):
        updated_icon = create_tray_icon_with_text("your_icon.png", new_text)
        tray_icon.setIcon(updated_icon)

    # 每5秒更新一次文本
    update_timer = QTimer()
    update_timer.timeout.connect(lambda: update_tray_text("30℃"))
    update_timer.start(5000)

    sys.exit(app.exec())

注意事项 #

• 需替换your_icon.png为你实际的图标路径
• 可根据图标尺寸调整文本字号、颜色和位置，确保文本清晰可见
• 动态更新时会重新生成图标，性能开销极低，无需担心卡顿

方案二：Linux专属——利用StatusNotifierItem接口 #

在Linux桌面环境中（如KDE、GNOME），QSystemTrayIcon基于StatusNotifierItem实现，可通过DBus接口直接设置图标旁的文本，无需修改图标。

代码示例 #

from PySide6.QtDBus import QDBusInterface

def set_tray_overlay_text(tray_icon, text):
    # 获取StatusNotifierItem的DBus接口
    sn_interface = QDBusInterface(
        "org.kde.StatusNotifierItem-1",
        "/StatusNotifierItem",
        "org.kde.StatusNotifierItem",
        QDBusInterface.sessionBus()
    )
    if sn_interface.isValid():
        # 设置OverlayText，部分桌面环境会将其显示在图标旁
        sn_interface.call("SetOverlayText", text)

注意事项 #

• 仅支持Linux系统，Windows和macOS无法使用
• 不同桌面环境对OverlayText的显示逻辑可能有差异，需自行测试适配

内容的提问来源于stack exchange，提问作者Matheus Lima