Class

UIPopoverPresentationController

An object that manages the display of content in a popover.

Overview

From the time a popover is presented until the time it is dismissed, UIKit uses an instance of this class to manage the presentation behavior. You use instances of this class as-is to configure aspects of the popover appearance and behavior for view controllers whose presentation style is set to popover.

In nearly all cases, you use this class as-is and do not create instances of it directly. UIKit creates an instance of this class automatically when you present a view controller using the popover style. You can retrieve that instance from the presented view controller’s popoverPresentationController property and use it to configure the popover behavior.

If you do not want to configure a popover immediately after presenting a view controller, you can use a delegate object to configure the popover instead. During the presentation process, the popover presentation controller calls various methods of its delegate—an object that conforms to the UIPopoverPresentationControllerDelegate protocol—to ask for information and to inform it about the state of the presentation. Your delegate object can use those methods to configure the popover and adjust its behavior as needed. For information about how to implement a delegate for a popover presentation controller, see UIPopoverPresentationControllerDelegate.

For information about how to display a view controller using a popover presentation controller, see Displaying Transient Content in a Popover.

Topics

Customizing the Popover Behavior

var delegate: UIPopoverPresentationControllerDelegate?

The delegate that handles popover-related messages.

protocol UIPopoverPresentationControllerDelegate

The methods of the UIPopoverPresentationControllerDelegate protocol let you customize the behavior of a popover-based presentation. A popover presentation controller notifies your delegate at appropriate points during the presentation process. You can use the delegate methods to customize this process and respond to changes dynamically.

Configuring the Popover Appearance

var popoverLayoutMargins: UIEdgeInsets

The margins that define the portion of the screen in which it is permissible to display the popover.

var backgroundColor: UIColor?

The color of the popover’s backdrop view.

var passthroughViews: [UIView]?

An array of views that the user can interact with while the popover is visible.

var popoverBackgroundViewClass: UIPopoverBackgroundViewMethods.Type?

The class to use for displaying the popover background content.

var canOverlapSourceViewRect: Bool

A Boolean value indicating whether the popover can overlap its view rectangle.

Specifying the Popover’s Anchor Point

var barButtonItem: UIBarButtonItem?

The bar button item on which to anchor the popover.

var sourceView: UIView?

The view containing the anchor rectangle for the popover.

var sourceRect: CGRect

The rectangle in the specified view in which to anchor the popover.

Configuring the Popover Arrows

var permittedArrowDirections: UIPopoverArrowDirection

The arrow directions that you allow for the popover.

var arrowDirection: UIPopoverArrowDirection

The arrow direction in use by the popover.

Relationships

See Also

Popovers

Displaying Transient Content in a Popover

Show a temporary interface on top of your app’s content on iPad.

class UIPopoverBackgroundView

The background appearance for a popover.

protocol UIPopoverBackgroundViewMethods

A set of methods that UIPopoverBackgroundView subclasses must implement.