关于开源项目 NSToolbar 的常见问题解决方案

关于开源项目 NSToolbar 的常见问题解决方案

1. 项目基础介绍

本项目是开源的 NSToolbar 示例，用于在 macOS 应用程序中创建和配置 NSToolbar。项目通过 AppKit 框架实现，主要使用 Swift 编程语言。

2. 新手常见问题及解决步骤

问题一：如何初始化并显示 NSToolbar？

问题描述： 新手在使用项目时，不知道如何创建并显示 NSToolbar。

解决步骤：

1. 确保你的 macOS 项目已正确配置了 AppKit 框架。
2. 在你的 ViewController 中，导入 AppKit 模块。
3. 创建一个新的 NSToolbar 实例。
4. 配置 NSToolbar 的属性，如 visibilityPriority、allows customization 等等。
5. 将 NSToolbarItem 添加到 NSToolbar 中。
6. 将 NSToolbar 添加到视图或窗口中。

import AppKit

class ViewController: NSViewController {
    let toolbar = NSToolbar()

    override func viewDidLoad() {
        super.viewDidLoad()
        setupToolbar()
    }

    func setupToolbar() {
        toolbar.frame = CGRect(x: 0, y: self.view.bounds.height - 40, width: self.view.bounds.width, height: 40)
        toolbar.visibilityPriority = .normal
        toolbar.allowsCustomization = true
        toolbar.displayMode = .iconOnly
        
        let item = NSToolbarItem(itemIdentifier: .init rawValue: "myItem")
        item.view = NSButton(title: "Click Me", target: self, action: #selector(buttonAction))
        toolbar.items = [item]

        self.view.addSubview(toolbar)
    }

    @objc func buttonAction() {
        print("Button clicked")
    }
}

问题二：如何为 NSToolbarItem 添加事件处理？

问题描述： 新手不知道如何为 NSToolbarItem 添加点击事件。

解决步骤：

1. 创建一个自定义的 NSToolbarItem。
2. 为该 NSToolbarItem 的 view 添加一个事件处理函数。
3. 将事件处理函数与对应的 UI 控件（如按钮）的 action 相关联。

let button = NSButton(title: "Click Me", target: self, action: #selector(buttonAction))
item.view = button

问题三：如何处理 NSToolbar 的空间不足导致的溢出问题？

问题描述： 当 NSToolbar 中的项目太多，无法在可视区域内完全显示时，部分项目会被放入溢出菜单中，新手不知道如何处理。

解决步骤：

1. 为 NSToolbarItem 设置不同的 overflowPriority 值，以控制哪些项目更可能被放入溢出菜单。
2. 通过观察 NSToolbar 的 actualVisibilityPriority 属性，判断项目是否已被放入溢出菜单。
3. 如果需要，可以自定义溢出菜单的行为或样式。

let item1 = NSToolbarItem(itemIdentifier: .init rawValue: "item1")
item1.view = NSButton(title: "Item 1", target: self, action: nil)
item1.overflowPriority = .high

let item2 = NSToolbarItem(itemIdentifier: .init rawValue: "item2")
item2.view = NSButton(title: "Item 2", target: self, action: nil)
item2.overflowPriority = .low

toolbar.items = [item1, item2]