Instance Method

presentOptionsMenuFromBarButtonItem:animated:

Displays an options menu and anchors it to the specified bar button item.

Declaration

- (BOOL)presentOptionsMenuFromBarButtonItem:(UIBarButtonItem *)item animated:(BOOL)animated;

Parameters

item

The bar button item to which to anchor the menu.

animated

Specify YES to animate the appearance of the menu or NO to display it immediately.

Return Value

YES if the options menu was displayed or NO if it was not. The options menu may not be displayed in cases where there are no appropriate items to include in the menu.

Discussion

The contents of the options menu are built dynamically based on three things:

  • The type of the document (as specified by the UTI property)

  • The set of installed apps that have registered support for opening documents

  • The actions that you have indicated as supported in the document interaction controller delegate’s documentInteractionController:canPerformAction: method

Options that cannot be performed on the current document are not included in the menu. For example, if the document cannot be opened by any known apps, the menu does not include options for opening it.

This method displays the options menu asynchronously. The document interaction controller dismisses the menu automatically when the user selects an appropriate option. You can also dismiss it programmatically using the dismissMenuAnimated: method.

To instead present a menu that contains only a list of apps capable of opening the current document, the presentOpenInMenuFromBarButtonItem:animated: method instead.

See Also

Presenting and Dismissing Menus

- presentOptionsMenuFromRect:inView:animated:

Displays an options menu and anchors it to the specified location in the view.

- presentOpenInMenuFromRect:inView:animated:

Displays a menu for opening the document and anchors that menu to the specified view.

- presentOpenInMenuFromBarButtonItem:animated:

Displays a menu for opening the document and anchors that menu to the specified bar button item.

- dismissMenuAnimated:

Dismisses the currently active menu.