Asks the delegate to provide the display mode to apply when a split view controller action occurs.
- iOS 8.0+
- Mac Catalyst 13.0+
- tvOS 9.0+
The split view controller whose action may be triggered. Use this object to obtain the current display mode and configuration of the split view interface.
The display mode to apply to the split view controller when the user performs specific actions.
At appropriate times, the split view controller calls this method to determine which display mode to apply to itself in response to user-initiated actions. The split view controller has a built-in gesture recognizer that changes the current display mode. The split view controller also vends a bar button item from its
display property that changes the display mode. The gesture recognizer is enabled using the
presents property of the split view controller. Apps must incorporate the bar button item into their interface.
Implement this method if you want to specify which display mode to apply to the split view controller in response to the user actions. The split view controller calls this method at appropriate times to obtain an updated value for the gesture and bar button item. If you do not implement this method or if your method returns
UISplit, the split view controller applies its own heuristics to determine which mode to apply when the next action is triggered. You cannot specify different display modes for the gesture and bar button item.