Instance Method

setTitle:

Sets the string displayed in the receiver when the user isn’t pressing the mouse button.

Declaration

- (void)setTitle:(NSString *)string;

Parameters

aString

The string to display.

Discussion

For pull-down menus that get their titles from a menu item, this method simply sets the pop-up button cell’s menu item to the first item in the menu. For pop-up menus, if a menu item whose title matches aString exists, this method makes that menu item the current selection; otherwise, it creates a new menu item with the title aString, adds it to the pop-up menu, and selects it.

See Also

Dealing with selection

- selectItem:

Selects the specified menu item.

- selectItemAtIndex:

Selects the item in the menu at the specified index.

- selectItemWithTag:

Selects the menu item with the specified tag.

- selectItemWithTitle:

Selects the item with the specified title.

selectedItem

The menu item last selected by the user.

indexOfSelectedItem

The index of the item last selected by the user.

- synchronizeTitleAndSelectedItem

Synchronizes the pop-up button’s displayed item with the currently selected menu item.