Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit 78cf7c82 authored by shawnlin's avatar shawnlin Committed by Shawn Lin
Browse files

Update the sdk doc of Default & ShortEdge cutout mode 

We now allow OEMs to extend the window to cutout area in below cutout
mode, only if the cutout overlaps at most 16dp with the app windows.
 - LAYOUT_IN_DISPLAY_CUTOUT_MODE_DEFUALT
 - LAYOUT_IN_DISPLAY_CUTOUT_MODE_SHORT_EDGES

Bug: 218603390
Test: make
Change-Id: I8c83cde40f321de2a301b5865445ff765c824d43
Merged-In: I8c83cde40f321de2a301b5865445ff765c824d43
parent 2a491d48

core/java/android/view/WindowManager.java

+18 −2
Original line number Diff line number Diff line
@@ -3128,7 +3128,8 @@ public interface WindowManager extends ViewManager { 


        /**

         * The window is allowed to extend into the {@link DisplayCutout} area, only if the

         * {@link DisplayCutout} is fully contained within a system bar. Otherwise, the window is

         * {@link DisplayCutout} is fully contained within a system bar or the {@link DisplayCutout}

         * is not deeper than 16 dp, but this depends on the OEM choice. Otherwise, the window is

         * laid out such that it does not overlap with the {@link DisplayCutout} area.

         *

         * <p>
@@ -3143,6 +3144,13 @@ public interface WindowManager extends ViewManager { 
         * The usual precautions for not overlapping with the status and navigation bar are

         * sufficient for ensuring that no important content overlaps with the DisplayCutout.

         *

         * <p>

         * Note: OEMs can have an option to allow the window to always extend into the

         * {@link DisplayCutout} area, no matter the cutout flag set, when the {@link DisplayCutout}

         * is on the different side from system bars, only if the {@link DisplayCutout} overlaps at

         * most 16dp with the windows.

         * In such case, OEMs must provide an opt-in/out affordance for users.

         *

         * @see DisplayCutout

         * @see WindowInsets

         * @see #layoutInDisplayCutoutMode
@@ -3155,8 +3163,16 @@ public interface WindowManager extends ViewManager { 
         * The window is always allowed to extend into the {@link DisplayCutout} areas on the short

         * edges of the screen.

         *

         * <p>

         * The window will never extend into a {@link DisplayCutout} area on the long edges of the

         * screen.

         * screen, unless the {@link DisplayCutout} is not deeper than 16 dp, but this depends on

         * the OEM choice.

         *

         * <p>

         * Note: OEMs can have an option to allow the window to extend into the

         * {@link DisplayCutout} area on the long edge side, only if the cutout overlaps at most

         * 16dp with the windows. In such case, OEMs must provide an opt-in/out affordance for

         * users.

         *

         * <p>

         * The window must make sure that no important content overlaps with the