PyQt5可隐藏QMenuBar高度控制问题及合规实现方案问询

核心解决思路 #

问题根源是直接动画QMenuBar的height属性（非可写）导致警告，改用可写的minimumHeight属性做动画，同时通过鼠标区域检测和按钮控制实现交互逻辑，完全规避非合规属性操作。

实现代码 #

import sys
from PyQt5.QtWidgets import (QMainWindow, QApplication, QMenuBar, QAction, 
                             QPushButton, QVBoxLayout, QWidget)
from PyQt5.QtCore import QPropertyAnimation, Qt, QEvent

class HidableMenuBarWindow(QMainWindow):
    def __init__(self):
        super().__init__()
        self.initUI()
        
    def initUI(self):
        self.setWindowTitle("可隐藏菜单栏示例")
        self.resize(800, 600)
        
        # 初始化菜单栏并记录默认高度
        self.menu_bar = QMenuBar(self)
        self.setMenuBar(self.menu_bar)
        self.default_menu_height = self.menu_bar.sizeHint().height()
        
        # 添加菜单示例
        file_menu = self.menu_bar.addMenu("文件")
        file_menu.addAction(QAction("新建", self))
        file_menu.addAction(QAction("打开", self))
        edit_menu = self.menu_bar.addMenu("编辑")
        edit_menu.addAction(QAction("复制", self))
        edit_menu.addAction(QAction("粘贴", self))
        
        # 创建动画：控制菜单栏的minimumHeight属性
        self.animation = QPropertyAnimation(self.menu_bar, b"minimumHeight")
        self.animation.setDuration(300)  # 动画时长300ms
        
        # 隐藏状态标记
        self.menu_hidden = False
        
        # 添加控制按钮
        central_widget = QWidget()
        self.setCentralWidget(central_widget)
        layout = QVBoxLayout(central_widget)
        self.toggle_btn = QPushButton("隐藏菜单栏")
        self.toggle_btn.clicked.connect(self.toggleMenuBar)
        layout.addWidget(self.toggle_btn)
        layout.addStretch()
        
        # 安装事件过滤器，监听鼠标进入顶部区域
        self.installEventFilter(self)
        
    def toggleMenuBar(self):
        if self.menu_hidden:
            # 展开菜单栏
            self.animation.setStartValue(0)
            self.animation.setEndValue(self.default_menu_height)
            self.animation.start()
            self.toggle_btn.setText("隐藏菜单栏")
            self.menu_hidden = False
        else:
            # 收起菜单栏
            self.animation.setStartValue(self.default_menu_height)
            self.animation.setEndValue(0)
            self.animation.start()
            self.toggle_btn.setText("展开菜单栏")
            self.menu_hidden = True
            
    def eventFilter(self, obj, event):
        # 仅在菜单栏隐藏时，检测鼠标进入窗口顶部区域
        if obj == self and event.type() == QEvent.MouseMove and self.menu_hidden:
            mouse_pos = event.pos()
            # 检测鼠标是否在窗口顶部20像素范围内（可调整）
            if mouse_pos.y() <= 20:
                self.toggleMenuBar()
        return super().eventFilter(obj, event)
    
    def resizeEvent(self, event):
        # 窗口resize时，确保菜单栏宽度匹配窗口
        self.menu_bar.setFixedWidth(self.width())
        super().resizeEvent(event)

if __name__ == "__main__":
    app = QApplication(sys.argv)
    window = HidableMenuBarWindow()
    window.show()
    sys.exit(app.exec_())

关键说明 #

• 动画合规性：使用minimumHeight属性（QWidget的可写属性）做动画，完全符合QPropertyAnimation的要求，无警告输出。
• 交互逻辑：
  • 按钮点击直接切换菜单栏的隐藏/展开状态
  • 菜单栏隐藏时，鼠标移动到窗口顶部20像素区域自动展开
• 自适应窗口：重写resizeEvent确保菜单栏宽度始终匹配窗口宽度，避免布局错乱

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