Instance Method

presentViewController:asPopoverRelativeToRect:ofView:preferredEdge:behavior:

Presents another view controller as a popover.

Declaration

- (void)presentViewController:(NSViewController *)viewController asPopoverRelativeToRect:(NSRect)positioningRect ofView:(NSView *)positioningView preferredEdge:(NSRectEdge)preferredEdge behavior:(NSPopoverBehavior)behavior;

Parameters

viewController

The other view controller to present as a popover.

positioningRect

The content size of the popover.

positioningView

The view relative to which the popover should be positioned. Must not be nil, or else the view controller raises an NSInvalidArgumentException exception.

preferredEdge

The edge of positioningView that the popover should prefer to be anchored to.

behavior

The popover’s closing behavior. See the NSPopoverBehavior enumeration.

Discussion

This method calls the presentViewController:animator: method on self (the presenting view controller), and passes a popover animator to that method.

The presented view controller is the delegate and the content view controller of the popover. You can use NSPopoverDelegate methods to customize the popover.

To dismiss the popover, call the dismissViewController: method on self (the presenting view controller).

See Also

Presenting Another View Controller’s Content

- presentViewController:animator:

Presents another view controller using a specified, custom animator for presentation and dismissal.

- dismissViewController:

Dismisses a presented view controller, using the same animator that presented it.

- presentViewControllerAsModalWindow:

Presents another view controller as a modal window, also known as an alert.

- presentViewControllerAsSheet:

Presents another view controller as a sheet.