Instance Property

modalPresentationCapturesStatusBarAppearance

Specifies whether a view controller, presented non-fullscreen, takes over control of status bar appearance from the presenting view controller.

Declaration

@property(nonatomic, assign) BOOL modalPresentationCapturesStatusBarAppearance;

Discussion

The default value of this property is NO.

When you present a view controller by calling the presentViewController:animated:completion: method, status bar appearance control is transferred from the presenting to the presented view controller only if the presented controller'€™s modalPresentationStyle value is UIModalPresentationFullScreen. By setting this property to YES, you specify the presented view controller controls status bar appearance, even though presented non-fullscreen.

The system ignores this property’s value for a view controller presented fullscreen.

See Also

Managing the Status Bar

childViewControllerForStatusBarHidden

Called when the system needs the view controller to use for determining status bar hidden/unhidden state.

childViewControllerForStatusBarStyle

Called when the system needs the view controller to use for determining status bar style.

preferredStatusBarStyle

The preferred status bar style for the view controller.

prefersStatusBarHidden

Specifies whether the view controller prefers the status bar to be hidden or shown.

preferredStatusBarUpdateAnimation

Specifies the animation style to use for hiding and showing the status bar for the view controller.

- setNeedsStatusBarAppearanceUpdate

Indicates to the system that the view controller status bar attributes have changed.