Swift：如何为自定义NSControl添加可在Connections面板显示的Sent Action

好问题！要让你的自定义AppKit控件（NSControl或NSView子类）在Xcode的Connections检查器里显示自定义的Sent Action，核心是利用Cocoa的目标-动作（Target-Action）机制，再配合Xcode识别的特定标记。下面分两种情况详细说明：

一、如果是NSControl子类（比如自定义NSButton、NSSlider） #

NSControl本身已经内置了Target-Action支持，要添加自定义的Sent Action非常简单：

1. 在你的自定义控件类中，用@objc @IBAction声明符合Cocoa规范的方法，方法签名通常接受一个sender参数：

   import Cocoa
   
   class CustomControl: NSControl {
       // 自定义Sent Action，会被Xcode识别并显示在Connections面板
       @objc @IBAction func customTriggerAction(_ sender: CustomControl) {
           // 这里可以编写自定义逻辑，比如额外的状态处理
           // 如果需要同时触发默认action，也可以调用super的sendAction方法
           super.sendAction(self.action, to: self.target)
       }
   }
   

   （Objective-C版本直接在头文件中声明- (IBAction)customTriggerAction:(CustomControl *)sender;即可）

2. 在Interface Builder中，将控件的类设置为你的CustomControl，打开Connections检查器，就能看到默认的action:和你自定义的customTriggerAction:两个Sent Action选项，直接拖线连接到响应对象即可。

二、如果是NSView子类（无内置Target-Action的基础视图） #

NSView本身没有自带的Target-Action机制，需要我们手动实现，同时让Xcode识别自定义Action：

步骤1：添加Target和Action属性 #

首先给自定义NSView添加target和action属性，暴露给Objective-C运行时：

import Cocoa

// 给类添加Objective-C标识符，帮助IB识别
@objc(CustomActionView)
class CustomActionView: NSView {
    // 目标对象，弱引用避免循环引用
    @objc weak var target: AnyObject?
    // 要触发的动作选择器
    @objc var action: Selector?

步骤2：声明@IBAction方法（让Xcode识别） #

添加带有@objc @IBAction修饰的方法，这个方法是给Xcode Connections面板“看”的，用来生成可连接的Action选项：

// 自定义Sent Action，会出现在Connections检查器中
    @objc @IBAction func viewDidTriggerAction(_ sender: CustomActionView) {
        // 实际触发动作的逻辑：调用AppKit的sendAction方法分发事件
        if let action = action, let target = target {
            NSApp.sendAction(action, to: target, from: self)
        }
    }

步骤3：在合适的时机触发Action #

比如在鼠标点击、视图状态变化时，调用上面的viewDidTriggerAction方法：

// 示例：处理鼠标点击事件，触发自定义Action
    override func mouseDown(with event: NSEvent) {
        super.mouseDown(with: event)
        viewDidTriggerAction(self)
    }
}

步骤4：在IB中连接Action #

将自定义View的类设置为CustomActionView后，打开Connections检查器，就能看到viewDidTriggerAction:这个Sent Action，直接拖线到ViewController的响应方法即可。

关键注意事项 #

• 所有要被Xcode识别的Action方法，必须用@objc修饰（Swift中），确保暴露给Objective-C运行时，因为Xcode的Interface Builder是基于Objective-C运行时扫描可连接的Action的。
• Action方法的签名尽量遵循Cocoa规范：接受一个sender参数，参数类型可以是你的自定义控件类、NSView或Any类型，这样Xcode才能正确识别并显示。

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