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

Commit 8e3584ed authored by Shawn Lin's avatar Shawn Lin Committed by Automerger Merge Worker
Browse files

Merge "Update the sdk doc of Default & ShortEdge cutout mode" am: bd8fb458 

Original change: https://android-review.googlesource.com/c/platform/frameworks/base/+/1989886

Change-Id: If933e5839e4e4005d0a424c29a57e74f66279771
parents ebf3f814 bd8fb458

core/java/android/view/WindowManager.java

+18 −2
Original line number Diff line number Diff line
@@ -3202,7 +3202,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>
@@ -3217,6 +3218,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
@@ -3229,8 +3237,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