UIPopoverControllerDelegate Protocol Reference

Conforms to
NSObject
Framework
/System/Library/Frameworks/UIKit.framework
Availability
Available in iOS 3.2 and later.
Companion guide
View Controller Catalog for iOS
Declared in
UIPopoverController.h
Related sample code

Overview

The UIPopoverControllerDelegate protocol defines the methods you can implement for the delegate of a UIPopoverController object. Popover controllers notify their delegate whenever user interactions would cause the dismissal of the popover and, in some cases, give the user a chance to prevent that dismissal.

For more information about the UIPopoverController class, see UIPopoverController Class Reference.

Tasks

Managing the Popover’s Dismissal

Instance Methods

popoverControllerDidDismissPopover:

Tells the delegate that the popover was dismissed.

- (void)popoverControllerDidDismissPopover:(UIPopoverController *)popoverController
Parameters
popoverController

The popover controller that was dismissed.

Discussion

The popover controller does not call this method in response to programmatic calls to the dismissPopoverAnimated: method. If you dismiss the popover programmatically, you should perform any cleanup actions immediately after calling the dismissPopoverAnimated: method.

You can use this method to incorporate any changes from the popover’s content view controller back into your application. If you do not plan to use the object in the popoverController parameter again, it is safe to release it from this method.

Availability
  • Available in iOS 3.2 and later.
Declared In
UIPopoverController.h

popoverControllerShouldDismissPopover:

Asks the delegate if the popover should be dismissed.

- (BOOL)popoverControllerShouldDismissPopover:(UIPopoverController *)popoverController
Parameters
popoverController

The popover controller to be dismissed.

Return Value

YES if the popover should be dismissed or NO if it should remain visible.

Discussion

This method is called in response to user-initiated attempts to dismiss the popover. It is not called when you dismiss the popover using the dismissPopoverAnimated: method of the popover controller.

If you do not implement this method in your delegate, the default return value is assumed to be YES.

Availability
  • Available in iOS 3.2 and later.
Declared In
UIPopoverController.h


© 2011 Apple Inc. All Rights Reserved. (Last updated: 2011-08-10)

Did this document help you? Yes It's good, but... Not helpful...