Android/frameworks_base
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Merge "Update the sdk doc of Default & ShortEdge cutout mode" am: bd8fb4581e am: 8e3584edd0

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

Change-Id: I635df81e55c08787647f400864e6212d01c20ef3
This commit is contained in:
Shawn Lin
2022-02-22 07:35:14 +00:00
committed by Automerger Merge Worker
parent 02272fd207 8e3584edd0
commit 68a72800b0
1 changed files with 18 additions and 2 deletions
Download Patch File Download Diff File Expand all files Collapse all files

20
core/java/android/view/WindowManager.java
View File

@@ -3202,7 +3202,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>
@@ -3217,6 +3218,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
@@ -3229,8 +3237,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