Instance Method

presentFromBarButtonItem:animated:completionHandler:

Present the picker in a popover that is anchored to the specified bar button item.

Declaration

- (BOOL)presentFromBarButtonItem:(UIBarButtonItem *)item animated:(BOOL)animated completionHandler:(UIPrinterPickerCompletionHandler)completion;

Parameters

item

The bar button item to use as the anchor for the popover.

animated

YES to animate the display of the picker or NO to display it without animations.

completion

A block to execute when the picker is dismissed. Use this block to receive information about the selected printer or information about any errors that occurred.

Return Value

YES if the picker was displayed or NO if the picker was already visible.

Discussion

This method presents the picker from a popover or from the view controller you specify using your delegate object. If you provide a delegate object and that object implements the printerPickerControllerParentViewController: method, UIKit presents the picker using the view controller you specify. If you do not provide a delegate, or your delegate object does not implement the printerPickerControllerParentViewController: method, UIKit presents the picker using a popover attached the bar button you specified in the item parameter.

After presenting the picker, the picker interface runs until the user or your app dismisses it. The picker interface provides ways for the user to cancel printing directly, all of which dismiss the picker. You can also dismiss the printer picker programmatically by calling the dismissAnimated: method.

Calling this method while the picker is currently displayed in a popover dismisses the popover.

See Also

Presenting and Dismissing the Picker

- presentAnimated:completionHandler:

Presents the picker from a view controller of your app.

- presentFromRect:inView:animated:completionHandler:

Present the picker in a popover that is anchored to a rectangle in the specified view.

- dismissAnimated:

Dismiss the picker.