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

Commit dea17b66 authored by shawnlin's avatar shawnlin Committed by Presubmit Automerger Backend
Browse files

[automerge] Update the sdk doc of Default & ShortEdge cutout mode 2p: b76fdc56 

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

Bug: 218603390
Change-Id: I6d299a5abb6f705490f59e2504ced4838881977e
parents 26d51f83 b76fdc56

core/java/android/view/WindowManager.java

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




        /**

        /**

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

         * 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.

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

         *

         *

         * <p>

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

         * The usual precautions for not overlapping with the status and navigation bar are

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

         * 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 DisplayCutout

         * @see WindowInsets

         * @see WindowInsets

         * @see #layoutInDisplayCutoutMode

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

         * The window is always allowed to extend into the {@link DisplayCutout} areas on the short

         * edges of the screen.

         * edges of the screen.

         *

         *

         * <p>

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

         * 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>

         * <p>

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

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