# NSPopUpButtonCell

FredKiefer@gmx.de
mhanni@sprintmail.com
Generated at 2026-02-17 21:02:56 +0000
1999 Free Software Foundation, Inc.
Software documentation for the NSPopUpButtonCell class
AppKit/NSPopUpButtonCell.h
Description forthcoming.
Warning the underscore at the start of the name of this instance variable indicates that, even though it is not technically private, it is intended for internal use within the package, and you should not use the variable in other code.
Description forthcoming.
addItemWithTitle:
title
Add an item to the popup with title.
addItemsWithTitles:
titles
Add a number of items to the reciever using the provided itemTitles array.
altersStateOfSelectedItem
Return `YES`, if the reciever changes the state of the item chosen by the user.
arrowPosition
Returns the current arrow position of the reciever.
attachPopUpWithFrame:
cellFrame
inView:
controlView
Attach popup
autoenablesItems
Returns `YES`, if the items are autoenabled.
dismissPopUp
Dismiss the reciever.
indexOfItem:
item
Return the index of item in the item array of the reciever.
indexOfItemWithRepresentedObject:
obj
Index of the item whose menu item's representedObject is equal to obj.
indexOfItemWithTag:
tag
Return index of the item with a tag equal to aTag.
indexOfItemWithTarget:
aTarget
andAction:
actionSelector
Index of the item in the reciever whose target and action are equal to aTarget and actionSelector.
indexOfItemWithTitle:
title
Return index of the item with the given title.
indexOfSelectedItem
Index of the currently selected item in the reciever.
initTextCell:
stringValue
pullsDown:
flag
Initialize with stringValue and pullDown. If pullDown is `YES`, the reciever will be a pulldown button.
insertItemWithTitle:
title
atIndex:
index
Adds an item with the given title at index. If an item already exists at index, it, and all items after it are advanced one position. Index needs to be within the valid range for the array of items in the popup button.
itemArray
Item array of the reciever.
itemAtIndex:
index
Return the item at index.
itemTitleAtIndex:
index
Set item title at the given index in the reciever.
itemTitles
Returns an array containing all of the current item titles.
itemWithTitle:
title
Return the item with title.
lastItem
Return the item listed last in the reciever.
menu
Return the menu for the popup.
numberOfItems
Number of items in the reciever.
performClickWithFrame:
frame
inView:
controlView
Perform the click operation with the given frame and controlView.
preferredEdge
Return the preferred edge.
pullsDown
Returns `YES`, if this is a pull-down
removeAllItems
Purges all items from the popup.
removeItemAtIndex:
index
Remove a given item based on its index, must be a valid index within the range for the item array of this popup.
removeItemWithTitle:
title
Remove a given item based on its title.
selectItem:
item
Select item in the reciever.
selectItemAtIndex:
index
Select item at the given index.
selectItemWithTitle:
title
Select the item with the given title.
selectedItem
The currently selected item in the reciever.
setAltersStateOfSelectedItem:
flag
Set to `YES`, if the state of the menu item selected in the reciever should be changed when it's selected.
Return `YES`, if the reciever changes the state of the item chosen by the user.
setArrowPosition:
pos
Sets the current arrow position of the reciever.
setAutoenablesItems:
flag
Set to `YES`, if the items are to be autoenabled.
setMenu:
menu
Set the menu for the popup.
setPreferredEdge:
preferredEdge
Set the preferred edge as described by edge. This is used to determine the edge which will open the popup when the screen is small.
setPullsDown:
flag
Set to `YES` to make the popup button a pull-down style control.
Set the pull-down state
setTitle:
aString
Set title to aString.
setUsesItemFromMenu:
flag
Set to `YES`, if the reciever should use a menu item for its title. `YES` is the default.
synchronizeTitleAndSelectedItem
Synchronizes the title and the selected item. This sets the selected item to the title of the reciever.
titleOfSelectedItem
Returns the title of the currently selected item in the reciever.
usesItemFromMenu
Returns `YES`, if the reciever uses a menu item for its title.