PyQt5中QMenu下拉菜单样式设置问题求助

核心原因 #

Windows 11环境中，PyQt5默认启用系统原生菜单渲染机制，自定义QSS样式会被原生样式覆盖，导致设置无效。

解决步骤 #

1. 禁用原生菜单渲染 #

在应用初始化阶段，通过QApplication属性和QMenuBar设置，强制关闭原生菜单渲染：

from PyQt5.QtCore import Qt
from PyQt5.QtWidgets import QApplication

# 全局禁用原生菜单栏
QApplication.setAttribute(Qt.AA_DontUseNativeMenuBar)
app = QApplication(sys.argv)

# 给当前窗口的菜单栏单独禁用原生渲染
menubar = self.menuBar()
menubar.setNativeMenuBar(False)

2. 通过QSS设置完整菜单样式 #

QAction的样式需通过QMenu的伪元素控制，以下是覆盖菜单及菜单项各状态的示例QSS：

menu_style = """
/* 菜单容器样式 */
QMenu {
    background-color: #f5f5f5;
    border: 1px solid #ddd;
    border-radius: 4px;
    padding: 4px 0;
}

/* 正常状态菜单项 */
QMenu::item {
    padding: 6px 30px;
    color: #2d2d2d;
    font-family: "Segoe UI";
    font-size: 13px;
}

/* 悬停/选中状态菜单项 */
QMenu::item:selected {
    background-color: #e1f0ff;
    color: #165dff;
}

/* 禁用状态菜单项 */
QMenu::item:disabled {
    color: #999;
}

/* 菜单分隔线样式 */
QMenu::separator {
    height: 1px;
    background-color: #eee;
    margin: 4px 8px;
}
"""

# 给目标QMenu应用样式
file_menu.setStyleSheet(menu_style)

完整可运行示例 #

from PyQt5.QtWidgets import QApplication, QMainWindow, QMenuBar, QMenu, QAction
from PyQt5.QtCore import Qt
import sys

class MainWindow(QMainWindow):
    def __init__(self):
        super().__init__()
        self.initUI()

    def initUI(self):
        self.setWindowTitle("QMenu自定义样式示例")
        self.setGeometry(300, 300, 400, 300)

        # 创建并配置菜单栏
        menubar = self.menuBar()
        menubar.setNativeMenuBar(False)

        # 创建文件菜单并应用样式
        file_menu = QMenu("文件", self)
        menu_style = """
        QMenu {
            background-color: #f5f5f5;
            border: 1px solid #ddd;
            border-radius: 4px;
            padding: 4px 0;
        }

        QMenu::item {
            padding: 6px 30px;
            color: #2d2d2d;
            font-family: "Segoe UI";
            font-size: 13px;
        }

        QMenu::item:selected {
            background-color: #e1f0ff;
            color: #165dff;
        }
        """
        file_menu.setStyleSheet(menu_style)

        # 添加菜单项
        new_action = QAction("新建", self)
        open_action = QAction("打开", self)
        file_menu.addAction(new_action)
        file_menu.addAction(open_action)

        menubar.addMenu(file_menu)

if __name__ == "__main__":
    QApplication.setAttribute(Qt.AA_DontUseNativeMenuBar)
    app = QApplication(sys.argv)
    window = MainWindow()
    window.show()
    sys.exit(app.exec_())

关键注意点 #

• 必须同时设置全局QApplication属性和QMenuBar的setNativeMenuBar(False)，否则Windows原生样式仍会生效。
• 所有菜单项的样式都通过QMenu的QSS伪元素定义，无需单独操作QAction。
• 可根据需求扩展QSS，比如添加图标位置、菜单宽度等自定义规则。

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