Instance Method

dismissModalViewControllerAnimated:

Dismisses the view controller that was presented by the receiver.

Declaration

- (void)dismissModalViewControllerAnimated:(BOOL)animated;

Parameters

animated

If YES, this method animates the view as it'€™s dismissed; otherwise, it does not. The style of animation is determined by the value in the modalTransitionStyle property of the view controller being dismissed.

Discussion

The presenting view controller is responsible for dismissing the view controller it presented. If you call this method on the presented view controller itself, however, it automatically forwards the message to the presenting view controller.

If you present several view controllers in succession, and thus build a stack of presented view controllers, calling this method on a view controller lower in the stack dismisses its immediate child view controller and all view controllers above that child on the stack. When this happens, only the top-most view is dismissed in an animated fashion; any intermediate view controllers are simply removed from the stack. The top-most view is dismissed using its modal transition style, which may differ from the styles used by other view controllers lower in the stack.

If you want to retain a reference to the receiver'€™s presented view controller, get the value in the modalViewController property before calling this method.

See Also

Deprecated

viewWillUnload

Called just before releasing the controller'€™s view from memory.

Deprecated
viewDidUnload

Called when the controller'€™s view is released from memory.

Deprecated
contentSizeForViewInPopover

The size of the view controller'€™s view while displayed in a popover.

Deprecated
presentModalViewController:animated:

Presents a modal view managed by the given view controller to the user.

Deprecated
wantsFullScreenLayout

A Boolean value indicating whether the view should underlap the status bar.

Deprecated
shouldAutorotateToInterfaceOrientation:

Returns a Boolean value indicating whether the view controller supports the specified orientation.

Deprecated
rotatingHeaderView

Returns the header view to transition during an interface orientation change.

Deprecated
rotatingFooterView

Returns the footer view to transition during an interface orientation change.

Deprecated
interfaceOrientation

Convenience property that provides the current orientation of the interface, meaningful only if the view controller is taking up the full screen.

Deprecated
willRotateToInterfaceOrientation:duration:

Sent to the view controller just before the user interface begins rotating.

Deprecated
willAnimateRotationToInterfaceOrientation:duration:

Sent to the view controller before performing a one-step user interface rotation.

Deprecated
didRotateFromInterfaceOrientation:

Sent to the view controller after the user interface rotates.

Deprecated
willAnimateFirstHalfOfRotationToInterfaceOrientation:duration:

Sent to the view controller before performing the first half of a user interface rotation.

Deprecated
didAnimateFirstHalfOfRotationToInterfaceOrientation:

Sent to the view controller after the completion of the first half of the user interface rotation.

Deprecated
willAnimateSecondHalfOfRotationFromInterfaceOrientation:duration:

Sent to the view controller before the second half of the user interface rotates.

Deprecated
searchDisplayController

The search display controller associated with the view controller.

Deprecated
modalViewController

The controller for the active presented view'€”that is, the view that is temporarily displayed on top of the view managed by the receiver.

Deprecated
shouldAutomaticallyForwardRotationMethods

Returns a Boolean value indicating whether rotation methods are forwarded to child view controllers.

Deprecated
automaticallyForwardAppearanceAndRotationMethodsToChildViewControllers

Returns a Boolean value that indicates whether appearance and rotation methods are forwarded.

Deprecated
presentMoviePlayerViewControllerAnimated:

Presents the movie player view controller using the standard movie player transition.

Deprecated
dismissMoviePlayerViewControllerAnimated

Dismisses a movie player view controller using the standard movie player transition.

Deprecated
viewControllerForUnwindSegueAction:fromViewController:withSender:

Called when an unwind segue action wants to search a container'€™s children for a view controller to handle the unwind action.

Deprecated
segueForUnwindingToViewController:fromViewController:identifier:

Called when an unwind segue action needs to transition between two view controllers.

Deprecated
bottomLayoutGuide

Indicates the lowest vertical extent for your onscreen content, for use with Auto Layout constraints.

Deprecated
topLayoutGuide

Indicates the highest vertical extent for your onscreen content, for use with Auto Layout constraints.

Deprecated
automaticallyAdjustsScrollViewInsets

A Boolean value that indicates whether the view controller should automatically adjust its scroll view insets.

Deprecated
canDisplayBannerAds

A boolean value that indicates whether the view controller is configured to display banner ads.

Deprecated
originalContentView

The originally configured content view of the view controller before banner ads were enabled.

Deprecated
presentingFullScreenAd

A boolean value that indicates whether the view controller is displaying a full-screen ad.

Deprecated
displayingBannerAd

A boolean value that indicates whether the view controller is displaying a banner ad.

Deprecated
prepareInterstitialAds

Prepares the iAd framework to display interstitial ads, which may involve prefetching ad assets.

Deprecated
interstitialPresentationPolicy

Determines whether interstitials should be presented at all and whether the framework or app should manage the presentation.

Deprecated
requestInterstitialAdPresentation

Asks the framework to display an interstitial ad.

Deprecated
shouldPresentInterstitialAd

Returns whether an interstitial ad should be displayed.

Deprecated