<!--
{
  "availability" : [
    "iOS: 13.0.0 -",
    "macCatalyst: 13.1.0 -",
    "macOS: 10.15.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "AppKit",
  "identifier" : "/documentation/AppKit/NSPickerTouchBarItem",
  "metadataVersion" : "0.1.0",
  "role" : "Class",
  "symbol" : {
    "kind" : "Class",
    "modules" : [
      "AppKit"
    ],
    "preciseIdentifier" : "c:objc(cs)NSPickerTouchBarItem"
  },
  "title" : "NSPickerTouchBarItem"
}
-->

# NSPickerTouchBarItem

A bar item that provides a picker control with multiple options.

```
class NSPickerTouchBarItem
```

## Topics

### Creating a picker item

[`+  pickerTouchBarItemWithIdentifier:images:selectionMode:target:action:`](/documentation/AppKit/NSPickerTouchBarItem/init(identifier:images:selectionMode:target:action:))

[`+  pickerTouchBarItemWithIdentifier:labels:selectionMode:target:action:`](/documentation/AppKit/NSPickerTouchBarItem/init(identifier:labels:selectionMode:target:action:))

### Configuring picker appearance

[`numberOfOptions`](/documentation/AppKit/NSPickerTouchBarItem/numberOfOptions)

[`-  setLabel:atIndex:`](/documentation/AppKit/NSPickerTouchBarItem/setLabel(_:at:))

[`-  labelAtIndex:`](/documentation/AppKit/NSPickerTouchBarItem/label(at:))

[`-  setImage:atIndex:`](/documentation/AppKit/NSPickerTouchBarItem/setImage(_:at:))

[`-  imageAtIndex:`](/documentation/AppKit/NSPickerTouchBarItem/image(at:))

[`collapsedRepresentationImage`](/documentation/AppKit/NSPickerTouchBarItem/collapsedRepresentationImage)

[`collapsedRepresentationLabel`](/documentation/AppKit/NSPickerTouchBarItem/collapsedRepresentationLabel)

[`controlRepresentation`](/documentation/AppKit/NSPickerTouchBarItem/controlRepresentation-swift.property)

[`ControlRepresentation`](/documentation/AppKit/NSPickerTouchBarItem/ControlRepresentation-swift.enum)

Constants that specify display styles for picker bar items.

### Configuring picker state

[`enabled`](/documentation/AppKit/NSPickerTouchBarItem/isEnabled)

[`-  isEnabledAtIndex:`](/documentation/AppKit/NSPickerTouchBarItem/isEnabled(at:))

[`-  setEnabled:atIndex:`](/documentation/AppKit/NSPickerTouchBarItem/setEnabled(_:at:))

### Handling selection

[`selectedIndex`](/documentation/AppKit/NSPickerTouchBarItem/selectedIndex)

[`selectionColor`](/documentation/AppKit/NSPickerTouchBarItem/selectionColor)

[`selectionMode`](/documentation/AppKit/NSPickerTouchBarItem/selectionMode-swift.property)

[`SelectionMode`](/documentation/AppKit/NSPickerTouchBarItem/SelectionMode-swift.enum)

Constants that specify selection modes for picker bar items.

### Handling picker interaction

[`action`](/documentation/AppKit/NSPickerTouchBarItem/action)

[`target`](/documentation/AppKit/NSPickerTouchBarItem/target)

### Configuring bar customization

[`customizationLabel`](/documentation/AppKit/NSPickerTouchBarItem/customizationLabel)

The localized string labeling this item during user customization.

## Relationships

### Inherits From

[`NSTouchBarItem`](/documentation/AppKit/NSTouchBarItem)

### Conforms To

[`CustomStringConvertible`](/documentation/Swift/CustomStringConvertible)

[`Hashable`](/documentation/Swift/Hashable)

[`NSObjectProtocol`](/documentation/ObjectiveC/NSObjectProtocol)

[`Sendable`](/documentation/Swift/Sendable)

[`NSCoding`](/documentation/Foundation/NSCoding)

[`CVarArg`](/documentation/Swift/CVarArg)

[`Equatable`](/documentation/Swift/Equatable)

[`CustomDebugStringConvertible`](/documentation/Swift/CustomDebugStringConvertible)

[`SendableMetatype`](/documentation/Swift/SendableMetatype)

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)