Instance Property

leftBarButtonItem

A custom bar button item displayed on the left (or leading) edge of the navigation bar when the receiver is the top navigation item.

Declaration

@property(nonatomic, strong) UIBarButtonItem *leftBarButtonItem;

Discussion

The contents of this property always refer to the first bar button item in the leftBarButtonItems array. Assigning a new value to this property replaces the first item in the leftBarButtonItems array with the new value. Setting this property to nil removes the first item in the array. If the bar button item is already in the array, it is moved from its current location to the front of the array.

In a right-to-left user interface, the position of the left bar button item is automatically flipped.

See Also

Specifying Custom Views

titleView

A custom view displayed in the center of the navigation bar when the receiver is the top item.

leftBarButtonItems

An array of custom bar button items to display on the left (or leading) side of the navigation bar when the receiver is the top navigation item.

rightBarButtonItems

An array of custom bar button items to display on the right (or trailing) side of the navigation bar when the receiver is the top navigation item.

rightBarButtonItem

A custom bar button item displayed on the right (or trailing) edge of the navigation bar when the receiver is the top navigation item.

- setLeftBarButtonItems:animated:

Sets the left bar button items, optionally animating the transition to the new items.

- setLeftBarButtonItem:animated:

Sets the custom bar button item, optionally animating the transition to the new item.

- setRightBarButtonItems:animated:

Sets the right bar button items, optionally animating the transition to the new items.

- setRightBarButtonItem:animated:

Sets the custom bar button item, optionally animating the transition to the view.

Beta Software

This documentation contains preliminary information about an API or technology in development. This information is subject to change, and software implemented according to this documentation should be tested with final operating system software.

Learn more about using Apple's beta software