如何在PyObj-C脚本中加载并访问XIB窗口中的控件？

一、先解决 IBOutlet 绑定失败的核心问题 #

IBOutlet 绑定失败大多是声明或操作流程有误，按以下步骤修正：

1. 在 WindowController 中正确声明 IBOutlet 属性
   导入对应 AppKit 类，用 objc.IBOutlet() 标记属性，变量名要和后续 XIB 绑定的标识一致：

   from AppKit import NSWindowController, NSSlider, NSDatePicker
   import objc
   
   class WindowController(NSWindowController):
       # 声明与控件对应的 IBOutlet
       slider = objc.IBOutlet()
       datePicker = objc.IBOutlet()
   
       def initWithWindowNibName_(self, nibName):
           self = super().initWithWindowNibName_(nibName)
           if self:
               # 基础初始化逻辑
               pass
           return self
   

2. 在 Interface Builder 中完成绑定

   • 打开 XIB 文件，在左侧 Document Outline 找到 Window Controller 对象；
   • 右键点击该对象，在弹出面板中找到你声明的 IBOutlet 变量（如 slider）；
   • 拖动变量旁的圆圈到 XIB 中对应的控件上，完成绑定；
   • 务必在 Identity Inspector 中，把 Window Controller 的 Custom Class 设置为你的 WindowController 类，Module 选择你的项目包名。

二、loadView/loadWindow 的作用与使用时机 #

• loadWindow：NSWindowController 的内置方法，控制器需要加载窗口时会自动调用，负责加载 nib 文件并实例化窗口、控件。无需手动调用，除非你要手动控制加载时机。
• loadView：属于 NSViewController 的方法，如果你用视图控制器管理 NSView 才需要关注，当前场景用 NSWindowController 可以忽略。

真正需要重写的是 windowDidLoad 方法——这是 NSWindowController 的生命周期钩子，窗口加载完成、所有 IBOutlet 绑定成功后会触发，适合在这里做控件的初始化修改：

class WindowController(NSWindowController):
    slider = objc.IBOutlet()
    datePicker = objc.IBOutlet()

    def windowDidLoad(self):
        super().windowDidLoad()
        # 此时控件已完全初始化，可直接操作
        self.setupSlider()
        self.setupDatePicker()

    def setupSlider(self):
        # 修改滑块旋钮颜色
        self.slider.setKnobColor_(NSColor.redColor())
        # 设置滑块范围与初始值
        self.slider.setMinValue_(0)
        self.slider.setMaxValue_(100)
        self.slider.setFloatValue_(50.0)

    def setupDatePicker(self):
        from Foundation import NSDate
        # 设置初始日期
        self.datePicker.setDateValue_(NSDate.date())
        # 修改文本颜色
        self.datePicker.setTextColor_(NSColor.blueColor())
        # 设置控件可用状态
        self.datePicker.setEnabled_(True)

三、IBOutlet 绑定失败的排查步骤 #

• 确认 XIB 中 Window Controller 的 Custom Class 与 Module 设置正确；
• 检查 IBOutlet 变量名与 XIB 绑定的标识完全一致（大小写敏感）；
• 确认 AppDelegate 中正确初始化并显示 WindowController：

  from AppKit import NSObject
  import objc
  
  class AppDelegate(NSObject):
      def applicationDidFinishLaunching_(self, notification):
          windowController = WindowController.alloc().initWithWindowNibName_("MainWindow")
          windowController.showWindow_(self)
  

四、无 IBOutlet 时通过代码查找控件 #

如果不想用 IBOutlet，可通过视图层级按类查找控件：

def findControlByClass(self, targetClass, parentView):
    for subview in parentView.subviews():
        if isinstance(subview, targetClass):
            return subview
        result = self.findControlByClass(targetClass, subview)
        if result:
            return result
    return None

# 在 windowDidLoad 中调用
def windowDidLoad(self):
    super().windowDidLoad()
    # 从窗口 contentView 中查找 NSSlider
    slider = self.findControlByClass(NSSlider, self.window().contentView())
    if slider:
        slider.setKnobColor_(NSColor.greenColor())

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