应用最小化到托盘

现代操作系统通常在桌面上提供一个特殊区域,称为系统托盘或通知区域。对一个GUI程序,如果在最小化时,程序做任务栏消失或者点击关闭按钮时,应用并不关闭,而是在系统托盘上显示一个图标,来表示该程序仍在运行,在托盘上打开上下文菜单,可以恢复程序正常显示,或者完全退出应用等操作。

要实现一个具有最小化到托盘功能的程序,要使用到类QSystemTrayIcon。该类为操作系统托盘的类,通过QSystemTrayIcon,可以在托盘上显示指定程序的图标,响应用户鼠标操作,显示指定消失,显示菜单等。

QSystenTrayIcon的常用函数有:

  • setIcon(self, icon:QIcon):设置程序在系统托盘上显示的图标。
  • setToolTip((self, tip: str): 设置鼠标放到图标上的提示文字。
  • setContextMenu(self, menu: QMenu): 设置上下文菜单,在托盘图标上点击鼠标右键时,将弹出该菜单。
  • show(self): 显示系统托盘图标。
  • hide(self): 隐藏系统托盘图标。
  • isSystemTrayAvailable(): 静态函数,判断系统是否支持托盘功能。
  • showMessage(self, title: str, msg: str, icon: 'QSystemTrayIcon.MessageIcon', msecs: int):

showMessage(self, title: str, msg: str, icon: QIcon, msecs: int):

显示状态通知消息(气球信息),参数title为标题信息,msg为要显示的信息,icon为气球信息中显示的图标, msecs为显示持续时间,单位为毫秒。

QSystenTrayIcon的常用消息:

  • messageClicked(self):用户单击使用showMessage()显示的消息时,将发出此信号。
  • activated(self, reason: 'QSystemTrayIcon.ActivationReason') :用户激活系统任务栏图标时,将发出此信号。reason指定激活的原因。

枚举变量QSystemTrayIcon.MessageIcon:

  • QSystemTrayIcon.NoIcon (0): 不显示图标。
  • QSystemTrayIcon. Information (1): 显示信息图标。
  • QSystemTrayIcon.Warning (2): 显示告警图标。
  • QSystemTrayIcon::Critical (3): 显示致命错误图标。

枚举变量 QSystemTrayIcon.ActivationReason:

  • QSystemTrayIcon.Unknown (0): 未知原因。
  • QSystemTrayIcon.Context (1): 请求系统托盘的上下文菜单。
  • QSystemTrayIcon.DoubleCLick (2): 鼠标双击。
  • QSystemTrayIcon.Trigger (3): 鼠标单击。
  • QSystemTrayIcon.MiddleClick (4): 点击鼠标中键

测试

测试程序以pyqt5-examples/desktop/systray.py为基础,演示对气球消息的控制设置,以及最小化到托盘后,如何通过菜单将程序恢复到常规状态和退出程序。完整代码如下:

import sys
from PyQt5.QtGui import QIcon
from PyQt5.QtWidgets import (QApplication, QDialog, QMessageBox, QPushButton,
                             QLabel, QCheckBox, QComboBox, QLineEdit, QSpinBox,
                             QMenu, QAction, QGridLayout, QHBoxLayout, QVBoxLayout,
                             QTextEdit,QGroupBox, QStyle, QSystemTrayIcon)
 
import resource_rc
 
class SystemTrayDemo(QDialog):
    def __init__(self):
        super(SystemTrayDemo, self).__init__()
        
        # 设置窗口标题
        self.setWindowTitle('实战PyQt5: 演示应用最小化到托盘')
        
        #设置窗口尺寸
        self.resize(400, 300)
        
        self.sysIcon = QIcon(':/panda.png')
        self.setWindowIcon(self.sysIcon)
        
        self.initUi()
        
    def initUi(self):
        
        self.createMessageGroupBox()
        self.createTrayIcon()
        
        mainLayout = QVBoxLayout()
        mainLayout.addWidget(self.grpMessageBox)
        self.setLayout(mainLayout)
        
        #让托盘图标显示在系统托盘上
        self.trayIcon.show()
        
    #创建托盘图标
    def createTrayIcon(self):
        aRestore = QAction('恢复(&R)', self, triggered = self.showNormal)
        aQuit = QAction('退出(&Q)', self, triggered = QApplication.instance().quit)
        
        menu = QMenu(self)
        menu.addAction(aRestore)
        menu.addAction(aQuit)
        
        self.trayIcon = QSystemTrayIcon(self)
        self.trayIcon.setIcon(self.sysIcon)
        self.trayIcon.setContextMenu(menu)
        self.trayIcon.messageClicked.connect(self.messageClicked)
        self.trayIcon.activated.connect(self.iconActivated)
    
    #气球信息控制部分
    def createMessageGroupBox(self):
        self.grpMessageBox = QGroupBox('气球消息')
        
        #==== 消息类型控制部分 ====#
        typeLabel = QLabel('消息类型:')
        
        self.cmbType = QComboBox()
        self.cmbType.addItem('无类型', QSystemTrayIcon.NoIcon)
        self.cmbType.addItem(self.style().standardIcon(QStyle.SP_MessageBoxInformation), 
                             '信息', QSystemTrayIcon.Information)
        self.cmbType.addItem(self.style().standardIcon(QStyle.SP_MessageBoxWarning),
                             '警告', QSystemTrayIcon.Warning)
        self.cmbType.addItem(self.style().standardIcon(QStyle.SP_MessageBoxCritical),
                             '错误', QSystemTrayIcon.Critical)
        self.cmbType.setCurrentIndex(1)
        
        #==== 消息显示持续时间部分 ====#
        durationLabel = QLabel('持续时间:')
        
        self.durationSpinBox = QSpinBox()
        self.durationSpinBox.setRange(5, 60)    #时间范围
        self.durationSpinBox.setSuffix(' s')    #后缀,秒
        self.durationSpinBox.setValue(15)       # 缺省时间 15秒
        
        #spinbox 右边的警告提示信息
        durationWarningLabel = QLabel('(一些系统可能会忽略消息显示的持续时间控制)')
        durationWarningLabel.setIndent(10)
        
        #==== 消息标题栏控制 ====#
        titleLabel = QLabel('标题:')
        
        self.titleEdit = QLineEdit('不能连接到网络')
        
        #==== 消息编辑栏 ====#
        bodyLabel = QLabel('消息:')
        self.bodyEdit = QTextEdit()
        self.bodyEdit.setPlainText('不要问我, 老实说吧,我也不知道原因。'
                                   '\n请点击气球图标获得更多信息')
        
        #==== 显示消息按钮 ====#
        showMessageButton = QPushButton('显示消息')
        showMessageButton.setDefault(True)
        showMessageButton.clicked.connect(self.showMessage)
        
        #==== 将上述部件加入到一个网格布局中
        msgLayout = QGridLayout()
        msgLayout.addWidget(typeLabel, 0, 0)     #0行0列
        msgLayout.addWidget(self.cmbType, 0, 1, 1, 2)    #0行1列, 占1行2列
        msgLayout.addWidget(durationLabel, 1, 0)    #1行0列
        msgLayout.addWidget(self.durationSpinBox, 1, 1)     #1行1列
        msgLayout.addWidget(durationWarningLabel, 1, 2, 1, 3)  #1行2列, 占1行3列
        msgLayout.addWidget(titleLabel, 2, 0)     #2行0列
        msgLayout.addWidget(self.titleEdit, 2, 1, 1, 4)  #2行1列, 占1行4列
        msgLayout.addWidget(bodyLabel, 3, 0)     #3行0列
        msgLayout.addWidget(self.bodyEdit, 3, 1, 2, 4)  #3行1列, 占2行4列
        msgLayout.addWidget(showMessageButton, 5, 4) #5行4列
        msgLayout.setColumnStretch(3, 1)
        msgLayout.setRowStretch(4, 1)
        
        self.grpMessageBox.setLayout(msgLayout)
     
    #显示气球信息   
    def showMessage(self):
        #根据消息类型获取图标
        icon = QSystemTrayIcon.MessageIcon(self.cmbType.itemData(self.cmbType.currentIndex()))
        self.trayIcon.showMessage(self.titleEdit.text(),         #标题
                                  self.bodyEdit.toPlainText(),   #信息
                                  icon,                          #图标
                                  self.durationSpinBox.value() * 1000) #信息显示持续时间
    
    #关闭事件处理, 不关闭,只是隐藏,真正的关闭操作在托盘图标菜单里
    def closeEvent(self, event):
        if self.trayIcon.isVisible():
            QMessageBox.information(self, '系统托盘', 
                                    '程序将继续在系统托盘中运行,要终止本程序,\n'
                                    '请在系统托盘入口的上下文菜单中选择"退出"')
            self.hide()
            event.ignore()
    
    def messageClicked(self):
        QMessageBox.information(None, '系统托盘',
                                '对不起,我已经尽力了。'
                                '也许你应该试着问一个人?')
     
       
    def iconActivated(self, reason):
        if reason in (QSystemTrayIcon.DoubleClick, QSystemTrayIcon.MiddleClick):
            self.showMessage()
    
if __name__ == '__main__':
    app = QApplication(sys.argv)
    
    #如果系统不支持最小化到托盘
    if not QSystemTrayIcon.isSystemTrayAvailable():
        QMessageBox.critical(None, '系统托盘', '本系统不支持托盘功能')
        sys.exit(1)
        
    QApplication.setQuitOnLastWindowClosed(False)
    
    window = SystemTrayDemo()
    window.show()
    sys.exit(app.exec())

运行结果如下图:

python程序 最小化运行 python 最小化到托盘_pyside2

应用最小化到系统托盘

本文知识点

  • 应用最小化到托盘的方法。
  • 控制托盘气球信息。
  • 通过托盘图标恢复应用的正常显示或者退出应用。