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.showDesktopPreviewInNaturalDisplayOrientationQML root item sizeResults
truesetThe application window remains exactly as specified in QML. The screen content remains unaffected.
truenot setThe application window is rotated by value specified in MCU.Config.displayRotationAngle. The screen content remains unaffected.
falsesetThe application window and its content are rotated by value specified in MCU.Config.displayRotationAngle.
falsenot setThe 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.

See also MCU.Config.displayRotationAngle and Configuring the display rotation.

Available under certain Qt licenses.
Find out more.