模态窗口中NSMenu.popUp菜单项禁用问题及方法差异解析

问题描述 #

在应用中使用NSMenu.popUp(positioning:at:in:)方法响应按钮点击弹出菜单时，发现模态窗口内的所有菜单项始终处于禁用状态；但改用NSMenu.popUpContextMenu(_:with:for:)方法时，菜单项能正常启用。测试代码如下：

@main
class AppDelegate: NSObject, NSApplicationDelegate {

    func applicationDidFinishLaunching(_ aNotification: Notification) {
        let window = NSWindow(contentViewController: ViewController())
        NSApp.runModal(for: window)
    }

}

class ViewController: NSViewController {

    override func loadView() {
        let button = NSButton(title: "Click", target: self, action: #selector(click(_:)))
        view = NSView(frame: CGRect(x: 0, y: 0, width: 400, height: 400))
        view.addSubview(button)
    }
    
    @objc func click(_ sender: Any?) {
        let menu = NSMenu(title: "")
        menu.addItem(withTitle: "asdf", action: #selector(asdf(_:)), keyEquivalent: "")
        menu.addItem(withTitle: "bla", action: nil, keyEquivalent: "")
        menu.items[0].target = self
        menu.items[1].target = self
//        NSMenu.popUpContextMenu(menu, with: NSApp.currentEvent!, for: view) // 此方法正常工作
        menu.popUp(positioning: nil, at: .zero, in: view) // 此方法下菜单项禁用
    }
    
    @IBAction func asdf(_ sender: Any) {
        print(0)
    }

}

问题原因 #

popUp(positioning:at:in:)方法的事件处理依赖应用的主事件循环，而模态窗口运行在独立的模态事件循环中。当在模态窗口内调用这个方法时，菜单无法正确关联到模态窗口的事件上下文，导致NSApplication无法找到菜单项的响应目标，最终将菜单项标记为禁用。

而popUpContextMenu(_:with:for:)方法强制要求传入触发事件和关联视图，会直接将菜单的事件处理绑定到触发事件所在的模态窗口的事件循环中，确保菜单项能正确找到响应对象并处理事件。

两个方法的核心区别 #

• popUp(positioning:at:in:)（实例方法）：

  • 适用于非上下文场景的菜单弹出（如工具栏按钮下拉菜单）
  • 默认关联应用主窗口的事件循环，在模态窗口等独立事件环境中，事件传递会中断
  • 无需传入触发事件，依赖当前默认的事件上下文

• popUpContextMenu(_:with:for:)（类方法）：

  • 专为上下文菜单设计（如右键菜单），但也适用于手动触发的菜单场景
  • 必须传入触发事件和关联视图，强制绑定到事件所在窗口的事件循环
  • 能兼容模态窗口、sheet等特殊窗口环境，确保事件响应正常

解决建议 #

在模态窗口场景下，优先使用popUpContextMenu(_:with:for:)方法，只需传入当前事件和关联视图即可确保菜单项正常启用。如果一定要使用popUp(positioning:at:in:)，需要手动将菜单的事件上下文绑定到模态窗口，但这种方式复杂度更高，不如前者可靠。

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