macOS菜单栏应用：NSMenuItem内嵌NSButton右键菜单失效求助

问题原因 #

当NSButton嵌入到NSMenuItem的视图中时，NSMenu会优先拦截右键事件，导致按钮的rightMouseDown(with:)方法无法被触发，这就是右键菜单失效的核心原因。

解决方案 #

通过自定义NSView子类，捕获右键事件并转发给对应的按钮，让按钮的右键逻辑正常执行。具体步骤如下：

• 创建自定义视图类：重写右键事件处理方法，将事件转发给点击位置的按钮；同时允许视图接受鼠标事件，确保事件能被捕获。
• 替换原有视图：将承载按钮的普通NSView替换为自定义视图类。
• 保持按钮的右键逻辑：原有的RightClickableButton子类无需大幅修改，只需确保菜单弹出逻辑正确。

完整代码示例 #

自定义右键可点击按钮 #

class RightClickableButton: NSButton {
    // 关联窗口标识，用于后续移除操作
    var windowIdentifier: String?
    
    override func rightMouseDown(with event: NSEvent) {
        let menu = NSMenu()
        menu.addItem(NSMenuItem(title: "移除该窗口", action: #selector(removeItemAction), keyEquivalent: ""))
        NSMenu.popUpContextMenu(menu, with: event, for: self)
    }
    
    @objc func removeItemAction() {
        // 发送通知触发移除逻辑
        if let windowId = windowIdentifier {
            NotificationCenter.default.post(name: NSNotification.Name("RemoveWindowItem"), object: windowId)
        }
    }
}

自定义视图类（用于承载按钮） #

class CustomButtonsView: NSView {
    override func rightMouseDown(with event: NSEvent) {
        // 转换点击坐标为视图本地坐标
        let localPoint = convert(event.locationInWindow, from: nil)
        // 检测点击目标是否为RightClickableButton
        if let clickedButton = hitTest(localPoint) as? RightClickableButton {
            clickedButton.rightMouseDown(with: event)
        } else {
            super.rightMouseDown(with: event)
        }
    }
    
    override func acceptsFirstMouse(for event: NSEvent?) -> Bool {
        return true
    }
}

修改后的AppDelegate #

@main
class AppDelegate: NSObject, NSApplicationDelegate {
    let statusItem = NSStatusBar.system.statusItem(withLength: NSStatusItem.variableLength)
    var buttonsView: CustomButtonsView!
    
    func applicationDidFinishLaunching(_ aNotification: Notification) {
        // 监听移除通知
        NotificationCenter.default.addObserver(self, selector: #selector(handleRemoveWindowItem(_:)), name: NSNotification.Name("RemoveWindowItem"), object: nil)
        
        let menu = NSMenu()
        let buttonsMenuItem = NSMenuItem()
        // 使用自定义视图替代普通NSView
        buttonsView = CustomButtonsView(frame: NSRect(x: 0, y: 0, width: 200, height: 30))
        
        // 示例窗口按钮
        let sampleButton = RightClickableButton(title: "示例窗口", target: self, action: #selector(jumpToWindow))
        sampleButton.frame = NSRect(x: 0, y: 0, width: 100, height: 30)
        sampleButton.windowIdentifier = "sample-window-1"
        buttonsView.addSubview(sampleButton)
        
        buttonsMenuItem.view = buttonsView
        menu.addItem(buttonsMenuItem)
        menu.addItem(NSMenuItem.separator())
        menu.addItem(NSMenuItem(title: "列出所有窗口", action: #selector(listAllWindows), keyEquivalent: ""))
        
        statusItem.menu = menu
        statusItem.button?.title = "窗口切换器"
    }
    
    @objc func jumpToWindow() {
        // 跳转至目标窗口的业务逻辑
        print("跳转至目标窗口")
    }
    
    @objc func listAllWindows() {
        // 列出所有运行应用窗口的业务逻辑
        print("列出所有窗口")
    }
    
    @objc func handleRemoveWindowItem(_ notification: Notification) {
        guard let windowId = notification.object as? String else { return }
        // 找到对应按钮并移除
        buttonsView.subviews.forEach { subview in
            if let button = subview as? RightClickableButton, button.windowIdentifier == windowId {
                button.removeFromSuperview()
                // 动态调整视图高度
                buttonsView.frame.size.height = buttonsView.subviews.isEmpty ? 0 : 30
            }
        }
    }
}

关键说明 #

• 自定义视图的rightMouseDown方法会先捕获事件，通过hitTest定位被点击的按钮，再调用按钮的右键处理方法，绕开NSMenu的事件拦截。
• acceptsFirstMouse返回true确保视图能接收鼠标事件，这是事件转发的必要前提。
• 示例中使用通知机制处理按钮移除，适配窗口切换器的业务需求，你可以根据实际场景调整移除逻辑。

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