C

MCU.Config.showDesktopPreviewInNaturalDisplayOrientation

Description

This property can be set to either true or false.

Default value is true.

Note: This property only affects the application's content rotation on the Qt platform, and it has no effect on the target device.

If it is true, the application is previewed on desktop in its natural orientation. If it is false, the application is previewed in the orientation sent to the display driver, which can vary depending on MCU.Config.displayRotationAngle.

This behavior depends on whether the QML root item size is explicitly set or not. The following table describes all the possible results:

MCU.Config.showDesktopPreviewInNaturalDisplayOrientation	QML root item size	Results
true	set	The application window remains exactly as specified in QML. The screen content remains unaffected.
true	not set	The application window is rotated by value specified in MCU.Config.displayRotationAngle. The screen content remains unaffected.
false	set	The application window and its content are rotated by value specified in MCU.Config.displayRotationAngle.
false	not set	The application window is not affected - has default size. The screen content is rotated by value specified in MCU.Config.displayRotationAngle.

Usage

MCU.Config {
    showDesktopPreviewInNaturalDisplayOrientation: true
}

Since

This property was introduced in QmlProject API 2.7.0.

QmlProject Manual

Available under certain Qt licenses.
Find out more.