Instance Method

presentFromRect:inView:animated:completionHandler:

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

Declaration

- (BOOL)presentFromRect:(CGRect)rect inView:(UIView *)view animated:(BOOL)animated completionHandler:(UIPrinterPickerCompletionHandler)completion;

Parameters

rect

The rectangle to which to anchor the popover. Specify the rectangle using the coordinate system of the view in the view parameter.

view

The view containing the specified rectangle.

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 view you specified.

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.

- presentFromBarButtonItem:animated:completionHandler:

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

- dismissAnimated:

Dismiss the picker.