Share via

IWindowManager.PropertyCompatIgnoreRequestedOrientation Field

  • Reference

Definition

Namespace:
Android.Views
Assembly:
Mono.Android.dll

Application level android.content.pm.PackageManager.Property PackageManager.Property for an app to inform the system that the app can be opted-in or opted-out from the compatibility treatment that avoids android.app.Activity#setRequestedOrientation Activity#setRequestedOrientation() loops.

[Android.Runtime.Register("PROPERTY_COMPAT_IGNORE_REQUESTED_ORIENTATION", ApiSince=34)]
public const string PropertyCompatIgnoreRequestedOrientation;
[<Android.Runtime.Register("PROPERTY_COMPAT_IGNORE_REQUESTED_ORIENTATION", ApiSince=34)>]
val mutable PropertyCompatIgnoreRequestedOrientation : string

Field Value

String
Attributes
RegisterAttribute

Remarks

Application level android.content.pm.PackageManager.Property PackageManager.Property for an app to inform the system that the app can be opted-in or opted-out from the compatibility treatment that avoids android.app.Activity#setRequestedOrientation Activity#setRequestedOrientation() loops. Loops can be triggered by the OEM-configured ignore requested orientation display setting (on Android 12 (API level 31) and higher) or by the landscape natural orientation of the device.

The treatment is disabled by default but device manufacturers can enable the treatment using their discretion to improve display compatibility.

With this property set to true, the system could ignore android.app.Activity#setRequestedOrientation Activity#setRequestedOrientation() call from an app if one of the following conditions are true: <ul> <li>Activity is relaunching due to the previous android.app.Activity#setRequestedOrientation Activity#setRequestedOrientation() call. <li>Camera compatibility force rotation treatment is active for the package. </ul>

Setting this property to false informs the system that the app must be opted-out from the compatibility treatment even if the device manufacturer has opted the app into the treatment.

<b>Syntax:</b>

&lt;application&gt;
              &lt;property
                android:name="android.window.PROPERTY_COMPAT_IGNORE_REQUESTED_ORIENTATION"
                android:value="true|false"/&gt;
            &lt;/application&gt;

Java documentation for android.view.WindowManager.PROPERTY_COMPAT_IGNORE_REQUESTED_ORIENTATION.

Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.

Applies to