PyQt4 QMenu无showTearOffMenu()方法，如何程序化恢复分离菜单状态？

问题背景 #

开发要求使用PyQt4，需实现应用重启后恢复QMenu的分离状态。已知PyQt5的QMenu有showTearOffMenu()方法，但PyQt4无此方法，且已设置isTearOffEnabled为True。调用该方法时出现错误：

AttributeError: 'QMenu' object has no attribute 'showTearOffMenu'

尝试exec_()、popup()、show()等方法均无法实现分离菜单效果，也找不到QMenu中用于分离的虚线项动作。相关代码如下：

# restore the menu widget state
self.menuWidgets = self.menubar.findChildren(QtWidgets.QMenu)
totalMenu = [(m.title(), m) for m in self.menuWidgets]
# get the value from setting to restore back the state
tearOffVisibleMenuNames = self.settings.value("tearOffMenuVisible")

for menu in totalMenu:
    name = menu[0]
    widget = menu[1]
    
    # if the menu is teared off in previously instance
    if tearOffVisibleMenuNames and name in tearOffVisibleMenuNames:
        widget.showTearOffMenu() # this is not working

解决方案 #

方法1：模拟点击分离项 #

PyQt4的QMenu分离项是一个隐藏QAction，通常文本为---（不同平台可能有差异），可通过遍历动作列表找到它并触发：

def trigger_tearoff_menu(menu):
    # 遍历菜单动作，定位分离项
    for action in menu.actions():
        if action.text() == "---":
            action.trigger()
            return True
    return False

# 替换原恢复逻辑中的调用
for menu in totalMenu:
    name = menu[0]
    widget = menu[1]
    
    if tearOffVisibleMenuNames and name in tearOffVisibleMenuNames:
        trigger_tearoff_menu(widget)

注意：若不同平台分离项文本不同，需根据实际环境调整判断条件。

方法2：调用Qt私有API（谨慎使用） #

PyQt4的QMenu内部有私有tearOffMenu()方法，可通过qt_metacall调用（方法索引需自行测试确认，以下示例为常见值）：

def show_tearoff_menu(menu):
    # 调用私有tearOffMenu方法
    menu.qt_metacall(QtCore.QMetaMethod.InvokeMetaMethod, 17, [])
    # 显示分离后的窗口
    tear_off_window = menu.findChild(QtWidgets.QWidget, "qt_menutearoff")
    if tear_off_window:
        tear_off_window.show()

# 恢复状态时调用
for menu in totalMenu:
    name = menu[0]
    widget = menu[1]
    
    if tearOffVisibleMenuNames and name in tearOffVisibleMenuNames:
        show_tearoff_menu(widget)

注意：私有API无官方支持，版本更新可能导致索引变化，存在兼容性风险。

补充：保存与恢复窗口几何信息 #

若需要保留分离菜单的位置和大小，可在保存状态时记录几何信息：

# 保存状态时
tear_off_menus = []
for menu in self.menuWidgets:
    tear_off_window = menu.findChild(QtWidgets.QWidget, "qt_menutearoff")
    if tear_off_window and tear_off_window.isVisible():
        tear_off_menus.append({
            "name": menu.title(),
            "geometry": tear_off_window.geometry()
        })
self.settings.setValue("tearOffMenus", tear_off_menus)

# 恢复状态时
tear_off_menus = self.settings.value("tearOffMenus")
if tear_off_menus:
    for info in tear_off_menus:
        name = info["name"]
        geometry = info["geometry"]
        for menu in self.menuWidgets:
            if menu.title() == name:
                trigger_tearoff_menu(menu)
                tear_off_window = menu.findChild(QtWidgets.QWidget, "qt_menutearoff")
                if tear_off_window:
                    tear_off_window.setGeometry(geometry)
                break

内容的提问来源于stack exchange，提问作者Woon Sin Tian