A control for selecting an item from a list.
SDK
Framework
@interface NSPopUpButton : NSButton
An NSPop object uses an NSPop object to implement its user interface.
Note that while a menu is tracking user input, programmatic changes to the menu, such as adding, removing, or changing items on the menu, is not reflected.
- initReturns an NSPop object initialized to the specified dimensions.
NSPopThe NSPop class defines the visual appearance of pop-up buttons that display pop-up or pull-down menus. Pop-up menus present the user with a set of choices, much the way radio buttons do, but using much less space. Pull-down menus also provide a set of choices but present the information in a slightly different way, usually to provide a set of commands from which the user can choose.
pullsA Boolean value indicating whether the button displays a pull-down or pop-up menu.
autoenablesA Boolean value indicating whether the button enables and disables its items every time a user event occurs.
- addAdds an item with the specified title to the end of the menu.
- addAdds multiple items to the end of the menu.
- insertInserts an item at the specified position in the menu.
- removeRemoves all items in the receiver’s item menu.
- removeRemoves the item with the specified title from the menu.
- removeRemoves the item at the specified index.
selectedThe menu item that was last selected by the user.
titleThe title of the item that was last selected by the user.
indexThe index of the item that was last selected by the user.
- objectReturns the index of the selected item.
selectedThe tag of the menu item that was last selected by the user.
- selectSelects the specified menu item.
- selectSelects the item in the menu at the specified index.
- selectSelects the menu item with the specified tag.
- selectSelects the item with the specified title.
- setSelects the item at a specific index using an object value.
menuThe menu associated with the pop-up button.
numberThe number of items in the menu.
itemThe array of menu item objects associated with the button.
- itemReturns the menu item at the specified index.
- itemReturns the title of the item at the specified index.
itemAn array of strings corresponding to the titles of the items in the menu.
- itemReturns the menu item with the specified title.
lastThe last item in the menu.
- indexReturns the index of the specified menu item.
- indexReturns the index of the menu item with the specified tag.
- indexReturns the index of the item with the specified title.
- indexReturns the index of the menu item that holds the specified represented object.
- indexReturns the index of the menu item with the specified target and action.
preferredThe edge of the button on which to display the menu when screen space is constrained.
- setSets the string displayed in the receiver when the user isn’t pressing the mouse button.
- setThis method has no effect.
- synchronizeEnsures that the item being displayed by the receiver agrees with the selected item.
NSPopPosted when an NSPop object receives a mouse-down event—that is, when the user is about to select an item from the menu.
NSButtonA control that defines an area on the screen that can be used to trigger actions.
NSColorA control that displays a color value and lets the user change that color value.
Display a calendar date and provide controls for editing the date value.
NSImageA display of image data from an NSImage object in a frame.
NSLevelA visual representation of a level or quantity, using discrete values.
A display of a file system path or virtual path information.
NSProgressAn interface that provides visual feedback to the user about the status of an ongoing task.
NSRuleAn interface for configuring a rule-based list of options.
NSPredicateA defined set of rules that allows the editing of predicate objects.
Provide a text field that is optimized for text-based search interfaces.
NSSegmentedDisplay one or more buttons in a single horizontal group.
Display a range of values from which the user selects a single value.
NSStepperAn interface with up and down arrow buttons for incrementing or decrementing a value.
Provide a simple interface for displaying and editing text, including support for password fields and secure forms of text entry.
Provide a text field whose text can be rendered in a visually distinct way so that users can recognize portions more easily.
Provide a space for controls under a window's title bar and above your custom content.
Display a list of values in a pop-up menu that lets the user select a value or type in a custom value.
NSMatrixA legacy interface for grouping radio buttons or other types of cells together.
NSSwitchA control that offers a binary choice.