QMenuBar中QWidgetAction的:hover效果失效问题求助

问题根源 #

• QLabel默认是非交互控件，不会主动响应鼠标hover事件
• QMenu的菜单项会拦截鼠标事件，导致内部嵌套的QLabel无法获取足够事件触发hover样式
• 全局样式表与QLabel单独设置的样式表存在优先级冲突，覆盖了hover规则

修复方案 #

方案1：自定义可响应hover的Label控件 #

通过自定义QLabel子类，开启hover事件监听并触发样式更新：

#First imports
import PyQt5, sys

from PyQt5 import QtWidgets, QtGui, QtCore
from PyQt5.QtCore import QTimer, Qt
from PyQt5.QtWidgets import QApplication, QMainWindow, QLabel, QFileDialog, QMdiSubWindow, QMdiArea, QToolBar, QAction, QTextEdit, QVBoxLayout, QWidget, QMenuBar, QWidgetAction, QMenu
from PyQt5.QtGui import QTextOption, QFont, QPixmap, QImage, QIcon

class HoverLabel(QLabel):
    def __init__(self, text):
        super().__init__(text)
        # 开启鼠标追踪与hover事件支持
        self.setMouseTracking(True)
        self.setAttribute(Qt.WA_Hover, True)

    def event(self, e):
        # 触发样式更新以响应hover状态变化
        if e.type() == QtCore.QEvent.HoverEnter or e.type() == QtCore.QEvent.HoverLeave:
            self.style().unpolish(self)
            self.style().polish(self)
            self.update()
        return super().event(e)

class UI(QMainWindow):
    def __init__(self):
        super(UI, self).__init__()

        self.setStyleSheet("""
        QMenuBar {
            background-color: white;
            color: black;
            border: 3px solid silver;
            font-weight: bold;
            font-size: 23px;
        }

        QMenuBar::item {
            background-color: white;
            border: 2px solid silver;
        }

        QMenuBar::item::selected {
            background-color: grey;
        }
        
        HoverLabel {
            border: 2px solid silver;
            background-color: white;
            color: black;
            padding: 4px;
        }
        
        HoverLabel:hover { 
            background-color: grey;
        }
        """)

        self.Menu = QMenuBar(self)
        self.Menu.resize(self.width(), 40)
        self.Menu.move(0, 0)
        
        self.File = self.Menu.addMenu('File')
        
        self.FileNew = QWidgetAction(self.File)
        # 使用自定义HoverLabel替代原生QLabel
        self.New = HoverLabel("New")
        self.New.setAlignment(QtCore.Qt.AlignCenter)

        self.FileNew.setDefaultWidget(self.New)
        self.File.addAction(self.FileNew)

def Start1():
    app = QApplication(sys.argv)
    win = UI()
    win.show()
    app.exec_()

Start1()

方案2：利用QMenu原生样式间接实现 #

通过给QMenu的菜单项设置hover样式，让内部QLabel透明继承样式，避免事件拦截问题：

# 修改样式表部分
self.setStyleSheet("""
QMenuBar {
    background-color: white;
    color: black;
    border: 3px solid silver;
    font-weight: bold;
    font-size: 23px;
}

QMenuBar::item {
    background-color: white;
    border: 2px solid silver;
}

QMenuBar::item::selected {
    background-color: grey;
}

/* 给QMenu菜单项设置hover样式 */
QMenu::item {
    background-color: white;
    border: 2px solid silver;
    padding: 4px;
}

QMenu::item:selected {
    background-color: grey;
}

/* 让QLabel透明背景，继承菜单项样式 */
QLabel {
    background-color: transparent;
    color: black;
}
""")

# 初始化QLabel时移除单独设置的样式表
self.New = QLabel("New")
self.New.setAlignment(QtCore.Qt.AlignCenter)

关键说明 #

• 方案1通过自定义控件直接解决QLabel不响应hover的问题，适合需要独立样式的场景
• 方案2利用QMenu原生事件处理机制，实现更简洁，适合样式与菜单项统一的场景

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