Instance Method

pushNavigationItem:animated:

Pushes the given navigation item onto the navigation bar's stack and updates the UI.

Declaration

- (void)pushNavigationItem:(UINavigationItem *)item animated:(BOOL)animated;

Parameters

item

The navigation item to push on the stack.

animated

YES if the navigation bar should be animated; otherwise, NO.

Discussion

Pushing a navigation item displays the item’s title in the center on the navigation bar. The previous top navigation item (if it exists) is displayed as a Back button on the left side of the navigation bar. If the new top item has a left custom view, it is displayed instead of the back button.

See Also

Pushing and Popping Items

- popNavigationItemAnimated:

Pops the top item from the navigation bar's stack and updates the UI.

- setItems:animated:

Replaces the navigation items currently managed by the navigation bar with the specified items.

items

An array of navigation items managed by the navigation bar.

topItem

The navigation item at the top of the navigation bar’s stack.

backItem

The navigation item that is immediately below the topmost item on navigation bar’s stack.