Instance Property


Returns a Boolean indicating whether the current input view is dismissed automatically when changing controls.


@property(nonatomic, readonly) BOOL disablesAutomaticKeyboardDismissal;

Return Value

YES to prevent the dismissal of the input view or NO if the input view may be dismissed.


Override this method in a subclass to allow or disallow the dismissal of the current input view (usually the system keyboard) when changing from a control that wants the input view to one that does not. Under normal circumstances, when the user taps a control that requires an input view, the system automatically displays that view. Tapping in a control that does not want an input view subsequently causes the current input view to be dismissed but may not in all cases. You can override this method in those outstanding cases to allow the input view to be dismissed or use this method to prevent the view from being dismissed in other cases.

The default implementation of this method returns YES when the modal presentation style of the view controller is set to UIModalPresentationFormSheet and returns NO for other presentation styles. Thus, the system normally does not allow the keyboard to be dismissed for modal forms.

See Also

Presenting a View Controller

- showViewController:sender:

Presents a view controller in a primary context.

- showDetailViewController:sender:

Presents a view controller in a secondary (or detail)€ context.

- presentViewController:animated:completion:

Presents a view controller modally.

- dismissViewControllerAnimated:completion:

Dismisses the view controller that was presented modally by the view controller.


The presentation style for modally presented view controllers.


Modal presentation styles available when presenting view controllers.


The transition style to use when presenting the view controller.


Transition styles available when presenting view controllers.


A Boolean value indicating whether the view controller enforces a modal behavior.


A Boolean value that indicates whether this view controller's view is covered when the view controller or one of its descendants presents a view controller.


A Boolean value that indicates whether the view controller specifies the transition style for view controllers it presents.


Posted when a split view controller is expanded or collapsed.