---
title: altersStateOfSelectedItem
framework: appkit
role: symbol
role_heading: Instance Property
path: appkit/nspopupbuttoncell/altersstateofselecteditem
---

# altersStateOfSelectedItem

A Boolean value that indicates if the pop-up button links the state of the selected menu item to the current selection.

## Declaration

```swift
var altersStateOfSelectedItem: Bool { get set }
```

## Discussion

Discussion When the value of this property is true (which is the default value), the state of the selected item is set to NSOnState. When the value of this property is false, the items in the menu are left alone. When you change the value of this property, the state of the currently selected item is updated appropriately. Note that this property affects only pop-up buttons (it is ignored for pull-down menus).

## See Also

### Related Documentation

- [selectItem(at:)](appkit/nspopupbuttoncell/selectitem(at:).md)
- [select(_:)](appkit/nspopupbuttoncell/select(_:).md)
- [selectedItem](appkit/nspopupbuttoncell/selecteditem.md)
- [selectItem(withTitle:)](appkit/nspopupbuttoncell/selectitem(withtitle:).md)

### Accessing menu attributes

- [menu](appkit/nspopupbuttoncell/menu.md)
- [pullsDown](appkit/nspopupbuttoncell/pullsdown.md)
- [autoenablesItems](appkit/nspopupbuttoncell/autoenablesitems.md)
- [preferredEdge](appkit/nspopupbuttoncell/preferrededge.md)
- [usesItemFromMenu](appkit/nspopupbuttoncell/usesitemfrommenu.md)
- [arrowPosition](appkit/nspopupbuttoncell/arrowposition.md)