Instance Property

disablesAutomaticKeyboardDismissal

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

Declaration

@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.

Discussion

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.

modalPresentationStyle

The presentation style for modally presented view controllers.

UIModalPresentationStyle

Modal presentation styles available when presenting view controllers.

modalTransitionStyle

The transition style to use when presenting the view controller.

UIModalTransitionStyle

Transition styles available when presenting view controllers.

modalInPresentation

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

Beta
definesPresentationContext

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.

providesPresentationContextTransitionStyle

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

UIViewControllerShowDetailTargetDidChangeNotification

Posted when a split view controller is expanded or collapsed.

Beta Software

This documentation contains preliminary information about an API or technology in development. This information is subject to change, and software implemented according to this documentation should be tested with final operating system software.

Learn more about using Apple's beta software