1.簡介
NSPopUpButton 是 macOS 開發中常用的控件之一，它提供了一個彈出菜單，用戶可以從中選擇一個選項。NSPopUpButton 可以包含多個 NSMenuItem 對象，每個 NSMenuItem 表示一個選項。
2.常用方法
下面是一些 NSPopUpButton 的常用功能和使用方法：
- 添加選項：您可以使用?
addItem(withTitle:)?方法向 NSPopUpButton 中添加選項。您也可以通過?addItems(withTitles:)?方法一次性添加多個選項。
popUpButton.addItem(withTitle: "Option 1")
popUpButton.addItems(withTitles: ["Option 2", "Option 3", "Option 4"])- 設置默認選中項：使用?
selectItem(at:)?方法可以設置默認選中的選項。您可以傳入選項的索引值作為參數。
popUpButton.selectItem(at: 0) // 默認選中第一個選項- 獲取選中項：您可以使用?
indexOfSelectedItem?屬性獲取當前選中項的索引值，使用?selectedItem?屬性獲取當前選中的 NSMenuItem 對象。
let selectedIndex = popUpButton.indexOfSelectedItem
let selectedItem = popUpButton.selectedItem- 處理選擇事件：您可以通過添加 target-action 或使用 Cocoa Bindings 來處理用戶選擇選項的事件。可以通過?
action?和?target?屬性來設置選擇事件的處理方法和目標對象。
popUpButton.action = #selector(handleSelection)
popUpButton.target = self@objc func handleSelection(sender: NSPopUpButton) {let selectedIndex = sender.indexOfSelectedItem// 處理選項選擇事件
}
- 自定義菜單項：您可以通過創建 NSMenuItem 對象并添加到 NSPopUpButton 中來實現自定義菜單項。您可以設置菜單項的標題、圖標、子菜單等屬性。
let menuItem = NSMenuItem(title: "Custom Option", action: #selector(customAction), keyEquivalent: "")
popUpButton.menu?.addItem(menuItem)@objc func customAction() {// 處理自定義菜單項點擊事件
}
3.簡單示例
import Cocoaclass ViewController: NSViewController {@IBOutlet weak var popUpButton: NSPopUpButton!override func viewDidLoad() {super.viewDidLoad()// 創建一個 NSPopUpButton 實例let popUpButton = NSPopUpButton(frame: NSRect(x: 20, y: 20, width: 100, height: 24))// 添加選項popUpButton.addItem(withTitle: "Option 1")popUpButton.addItem(withTitle: "Option 2")popUpButton.addItem(withTitle: "Option 3")// 設置默認選中的選項popUpButton.selectItem(at: 0)// 將 NSPopUpButton 添加到視圖中view.addSubview(popUpButton)}
}
在這個示例中，我們在 ViewController 中創建了一個 NSPopUpButton 實例，并添加了三個選項。然后設置了默認選中的選項為第一個選項，并將 NSPopUpButton 添加到視圖中。
也可以通過 Interface Builder 在 Storyboard 中拖拽一個 NSPopUpButton 控件到界面上，并通過代碼或 Storyboard 連接 IBOutlet 來操作它。
4.注意事項
- 線程安全：在多線程環境下，操作 UI 控件需要在主線程中進行。確保所有對 NSPopUpButton 的操作都在主線程中執行，以避免出現線程安全問題。
- 內存管理：在使用 NSPopUpButton 時，需要注意內存管理。確保正確地管理 NSPopUpButton 對象的生命周期，避免出現內存泄漏或野指針等問題。
- 用戶體驗：在設計 NSPopUpButton 時，考慮用戶體驗是非常重要的。確保選項的排列清晰、易于理解，避免選項過多導致用戶選擇困難。
- 可訪問性：為了提高應用程序的可訪問性，確保 NSPopUpButton 控件可以被屏幕閱讀器等輔助技術正確識別和操作。為 NSPopUpButton 和其選項添加適當的標簽和描述，以便視障用戶能夠正確地使用。
- 樣式和布局：根據應用程序的設計風格和布局要求，可以通過設置 NSPopUpButton 的樣式、尺寸和布局來實現不同的外觀效果。確保 NSPopUpButton 與應用程序的整體風格保持一致。
