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

Update the sdk doc of Default & ShortEdge cutout mode

Browse Source 
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
This commit is contained in:
shawnlin
2022-02-09 13:57:19 +08:00
committed by Shawn Lin
parent 038fd80ce8
commit b76fdc5630
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

@@ -3222,7 +3222,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>
@@ -3237,6 +3238,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
@@ -3249,8 +3257,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