Language

IWindowManager.PropertyCompatAllowExcludeCaptionInsets Field

Definition

Application level android.content.pm.PackageManager.Property PackageManager.Property for an app to inform the system that it needs to be opted-out from the compatibility treatment that sandboxes the android.content.res.Configuration API when caption insets are force consumed.

[Android.Runtime.Register("PROPERTY_COMPAT_ALLOW_EXCLUDE_CAPTION_INSETS", ApiSince=37)]
public const string PropertyCompatAllowExcludeCaptionInsets;
[<Android.Runtime.Register("PROPERTY_COMPAT_ALLOW_EXCLUDE_CAPTION_INSETS", ApiSince=37)>]
val mutable PropertyCompatAllowExcludeCaptionInsets : string

Field Value

Attributes

Remarks

Application level PackageManager.Property for an app to inform the system that it needs to be opted-out from the compatibility treatment that sandboxes the Configuration API when caption insets are force consumed.

The treatment can be enabled by device manufacturers for applications that don't handle consumption of WindowInsets.Type.captionBar insets which can lead to top or bottom UI elements being cropped. The treatment will sandbox Configuration.screenHeightDp to exclude caption insets.

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

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

<application>
<property
    android:name="android.window.PROPERTY_COMPAT_ALLOW_EXCLUDE_CAPTION_INSETS"
    android:value="false"/>
</application>

Android reference for android.view.WindowManager.PROPERTY_COMPAT_ALLOW_EXCLUDE_CAPTION_INSETS.

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