Share via

WindowManager.PropertyCompatAllowUserAspectRatioFullscreenOverride Field

  • Reference

Definition

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

Caution

Use 'Android.Views.IWindowManager.PropertyCompatAllowUserAspectRatioFullscreenOverride'. This class will be removed in a future release.

Application level android.content.pm.PackageManager.Property PackageManager.Property tag that (when set to false) informs the system the app has opted out of the full-screen option of the user aspect ratio compatibility override settings.

[Android.Runtime.Register("PROPERTY_COMPAT_ALLOW_USER_ASPECT_RATIO_FULLSCREEN_OVERRIDE", ApiSince=35)]
[System.Obsolete("Use 'Android.Views.IWindowManager.PropertyCompatAllowUserAspectRatioFullscreenOverride'. This class will be removed in a future release.")]
public const string PropertyCompatAllowUserAspectRatioFullscreenOverride;
[<Android.Runtime.Register("PROPERTY_COMPAT_ALLOW_USER_ASPECT_RATIO_FULLSCREEN_OVERRIDE", ApiSince=35)>]
[<System.Obsolete("Use 'Android.Views.IWindowManager.PropertyCompatAllowUserAspectRatioFullscreenOverride'. This class will be removed in a future release.")>]
val mutable PropertyCompatAllowUserAspectRatioFullscreenOverride : string

Field Value

String
Attributes
RegisterAttribute ObsoleteAttribute

Remarks

Application level android.content.pm.PackageManager.Property PackageManager.Property tag that (when set to false) informs the system the app has opted out of the full-screen option of the user aspect ratio compatibility override settings. (For background information about the user aspect ratio compatibility override, see #PROPERTY_COMPAT_ALLOW_USER_ASPECT_RATIO_OVERRIDE.)

When users apply the full-screen compatibility override, the orientation of the activity is forced to android.content.pm.ActivityInfo#SCREEN_ORIENTATION_USER.

The user override is intended to improve the app experience on devices that have the ignore orientation request display setting enabled by OEMs (enables compatibility mode for fixed orientation on Android 12 (API level 31) or higher; see Large screen compatibility mode for more details).

To opt out of the full-screen option of the user aspect ratio compatibility override, add this property to your app manifest and set the value to false. Your app will have full-screen option removed from the list of user aspect ratio override options in device settings, and users will not be able to apply full-screen override to your app.

<b>Note:</b> If #PROPERTY_COMPAT_ALLOW_USER_ASPECT_RATIO_OVERRIDE is false, this property has no effect.

Not setting this property at all, or setting this property to true has no effect.

<b>Syntax:</b>

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

Java documentation for android.view.WindowManager.PROPERTY_COMPAT_ALLOW_USER_ASPECT_RATIO_FULLSCREEN_OVERRIDE.

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