# NSPopUpButton

scottc@net-community.com
mhanni@sprintmail.com
Generated at 2026-06-27 19:09:52 +0000

Popup list class

1996 Free Software Foundation, Inc.
Software documentation for the NSPopUpButton class
AppKit/NSPopUpButton.h
Description forthcoming.
addItemWithTitle:
title

Inserts a new item with title as its title at the end of the list and synchronizes the NSPopUpButton's title with the title of the selected item.

See Also: [NSPopUpButtonCell -addItemWithTitle:] -synchronizeTitleAndSelectedItem

addItemsWithTitles:
itemTitles

Inserts a new list of items with titles as titles at the end of the list and synchronizes the NSPopUpButton's title with the title of the selected item.

See Also: [NSPopUpButtonCell -addItemsWithTitles:] -synchronizeTitleAndSelectedItem

autoenablesItems
Description forthcoming.
indexOfItem:
anObject
Description forthcoming.
indexOfItemWithRepresentedObject:
anObject
Description forthcoming.
indexOfItemWithTag:
tag

Returns the index of the item with tag as its tag. Returns -1 if the cell is not found

See Also: [NSPopUpButtonCell -indexOfItemWithTag:] -indexOfItemWithTitle: -indexOfItemWithRepresentedObject:

indexOfItemWithTarget:
target
andAction:
actionSelector
Description forthcoming.
indexOfItemWithTitle:
title

Returns the index of the item with title as its title. Returns -1 if the cell is not found

See Also: [NSPopUpButtonCell -indexOfItemWithTitle:] -indexOfItemWithTag: -indexOfItemWithRepresentedObject:

indexOfSelectedItem

Returns the index of the selected item

See Also: [NSPopUpButtonCell -indexOfSelectedItem]

initWithFrame:
frameRect
pullsDown:
flag

Initialize and returns a new NSPopUpButton into the frame frameRect and specified by flag if the NSPopUpButton is a pull-down list

See Also: -setPullsDown: [NSView -initWithFrame:]

insertItemWithTitle:
title
atIndex:
index

Inserts a new item with title as its title at the specified index and synchronizes the NSPopUpButton's title with the title of the selected item.

See Also: [NSPopUpButtonCell -insertItemWithTitle:atIndex:] -synchronizeTitleAndSelectedItem

itemArray
Description forthcoming.
itemAtIndex:
index

Returns the NSMenuItem at index index or `nil` if index is out of range

See Also: [NSPopUpButtonCell -itemAtIndex:]

itemTitleAtIndex:
index

Returns the item's title at index index

itemTitles

Returns an array containing the items's titles

itemWithTitle:
title

Returns the NSMenuItem with title as its title

lastItem

Returns the last NSMenuItem of the list

numberOfItems

Returns the number of items in the item list

See Also: [NSPopUpButtonCell -numberOfItems]

preferredEdge
Description forthcoming.
pullsDown

Returns whether the NSPopUpButton's cell has a pulls-down list (`YES`) or a pop-up list (`NO`)

See Also: -setPullsDown: [NSPopUpButtonCell -pullsDown]

removeAllItems

Removes all items from the item list and synchronizes the NSPopUpButton's title with the title of the selected

See Also: [NSPopUpButtonCell -removeAllItems] -removeItemWithTitle: -synchronizeTitleAndSelectedItem

removeItemAtIndex:
index

Removes the item at the specified index index from the item list and synchronizes the NSPopUpButton's title with the title of the selected

See Also: [NSPopUpButtonCell -removeItemAtIndex:] -removeAllItems -removeItemWithTitle: -synchronizeTitleAndSelectedItem

removeItemWithTitle:
title

Removes the item specified with title as its title from the item list and synchronizes the NSPopUpButton's title with the title of the selected

See Also: [NSPopUpButtonCell -removeItemWithTitle:] -removeAllItems -removeItemAtIndex: -synchronizeTitleAndSelectedItem

selectItem:
anObject
Description forthcoming.
selectItemAtIndex:
index

Select the item at index index and synchronizes the NSPopUpButton's title with the title of the selected

See Also: [NSPopUpButtonCell -selectItemAtIndex:] -synchronizeTitleAndSelectedItem

selectItemWithTag:
tag
Description forthcoming.
selectItemWithTitle:
title

Select the item with title title and synchronizes the NSPopUpButton's title with the title of the selected

See Also: [NSPopUpButtonCell -selectItemWithTitle:] -synchronizeTitleAndSelectedItem

selectedItem

Returns the selected item

See Also: [NSPopUpButtonCell -selectedItem]

setAutoenablesItems:
flag
Description forthcoming.
setPreferredEdge:
edge
Description forthcoming.
setPullsDown:
flag

Sets whether the NSPopUpButton's cell has a pulls-down list (`YES`) or a pop-up list (`NO`)

See Also: -pullsDown [NSPopUpButtonCell -setPullsDown:]

setTitle:
aString
Description forthcoming.
synchronizeTitleAndSelectedItem
Description forthcoming.
titleOfSelectedItem

Returns the title of the selected item

See Also: [NSPopUpButtonCell -titleOfSelectedItem]