NSTabViewController.TabStyle.toolbar – 一种自动将任何选项卡添加到窗口工具栏的样式。选项卡视图控制器控制窗口的工具栏并将自己设置为工具栏的委托。
https://developer.apple.com/documentation/appkit/nstabviewcontroller/tabstyle
请记住，我们可以创建 NSWindowController 并将 NSWindow.contentViewController 设置为 NSTabViewController 以获取标准的 macOS 首选项窗口。
这是一个由代码 (Swift 4) 制成的首选项窗口：
文件：PreferencesPageID.swift - 保留 Preference 页面属性。在回调中使用。
enum PreferencesPageID: Int, CaseIterable {
case generic, misc
var image: NSImage? {
switch self {
case .generic:
return NSImage(named: NSImage.folderSmartName)
case .misc:
return NSImage(named: NSImage.networkName)
}
}
var title: String {
switch self {
case .generic:
return "Some"
case .misc:
return "Other"
}
}
}
文件：PreferencesTabView.swift - 表示首选项页面内容视图。
class PreferencesTabView: View {
let id: PreferencesPageID
init(id: PreferencesPageID) {
self.id = id
super.init()
}
required init?(coder decoder: NSCoder) {
fatalError()
}
override func setupUI() {
switch id {
case .generic:
backgroundColor = .red
setIntrinsicContentSize(CGSize(width: 400, height: 200))
case .misc:
backgroundColor = .blue
setIntrinsicContentSize(CGSize(width: 400, height: 300))
}
}
}
文件：PreferenceItemViewController.swift - 保持 Preference 页面内容视图的控制器。主要用于满足 macOS SDK 要求。
class PreferenceItemViewController: ViewController {
private let contentView: PreferencesTabView
override func loadView() {
view = contentView
}
init(view: PreferencesTabView) {
contentView = view
super.init(nibName: nil, bundle: nil)
}
required init?(coder: NSCoder) {
fatalError()
}
override func viewDidLayout() {
super.viewDidLayout()
preferredContentSize = view.intrinsicContentSize
}
}
文件：PreferencesViewController.swift - 用作NSWindow.contentViewController。
class PreferencesViewController: TabViewController {
enum Event {
case selected(PreferencesPageID)
}
var eventHandler: ((Event) -> Void)?
override func setupUI() {
tabStyle = .toolbar // This will "turn" View Controller to standard Preferences window.
transitionOptions = .allowUserInteraction
canPropagateSelectedChildViewControllerTitle = false
let views = [PreferencesTabView(id: .generic), PreferencesTabView(id: .misc)]
views.forEach {
let item = NSTabViewItem(viewController: PreferenceItemViewController(view: $0))
item.label = $0.id.title
item.image = $0.id.image
addTabViewItem(item)
}
}
override func tabView(_ tabView: NSTabView, didSelect tabViewItem: NSTabViewItem?) {
super.tabView(tabView, didSelect: tabViewItem)
if let view = tabViewItem?.viewController?.view as? PreferencesTabView {
eventHandler?(.selected(view.id))
}
}
}
文件：PreferencesWindowController.swift - 首选项窗口控制器。
private class PreferencesWindowController: NSWindowController {
private(set) lazy var viewController = PreferencesViewController()
init() {
let rect = CGRect(x: 400, y: 200, width: 400, height: 300)
let window = NSWindow(contentRect: rect, styleMask: [.titled, .closable], backing: .buffered, defer: true)
super.init(window: window)
setupHandlers()
let frameSize = window.contentRect(forFrameRect: window.frame).size
viewController.view.setFrameSize(frameSize)
window.contentViewController = viewController
}
required init?(coder: NSCoder) {
fatalError()
}
// MARK: - Private
private func setupHandlers() {
viewController.eventHandler = { [weak self] in
switch $0 {
case .selected(let id):
self?.window?.title = "Preferences — " + id.title
}
}
}
}
用法：
public class Application: NSApplication {
private lazy var preferencesController = PreferencesWindowController()
// Called from code or via IBAction
private func showPreferences() {
preferencesController.showWindow(nil)
}
}