Instance Property


The current screen mode associated with the screen.


iOS, Mac Catalyst
var currentMode: UIScreenMode? { get set }
var currentMode: UIScreenMode? { get }


The default value of this property is the mode containing the highest resolution supported by the screen.

On iOS, you can change the value of this property to support different resolutions as needed. For example, you might want to lower the default resolution to one that your application supports more readily. The value must be one of the values described in the availableModes property.

On tvOS, the screen mode is read-only.

See Also

Accessing the Screen Modes

var preferredMode: UIScreenMode?

The preferred display mode for the screen.

var availableModes: [UIScreenMode]

The display modes that can be associated with the screen.