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

Commit e6feb7d1 authored by Adrian Roos's avatar Adrian Roos
Browse files

GestureNav: Clarify javadoc in regards to exclusion limits 

Bug: 124518180
Test: m checkapi
Change-Id: I43b0b890a763e339deb246cabf9adbf011eae088
parent 36151597

core/java/android/view/View.java

+7 −0
Original line number Diff line number Diff line
@@ -10556,6 +10556,13 @@ public class View implements Drawable.Callback, KeyEvent.Callback, 
     *

     * <p>Do not modify the provided list after this method is called.</p>

     *

     * <p>Note: the system will put a limit of <code>200dp</code> on the vertical extent of the

     * exclusions it takes into account. The limit does not apply while the navigation

     * bar is {@link #SYSTEM_UI_FLAG_IMMERSIVE_STICKY stickily} hidden, nor to the

     * {@link android.inputmethodservice.InputMethodService input method} and

     * {@link Intent#CATEGORY_HOME home activity}.

     * </p>

     *

     * @param rects A list of precision gesture regions that this view needs to function correctly

     */

    public void setSystemGestureExclusionRects(@NonNull List<Rect> rects) {

core/java/android/view/WindowInsets.java

+9 −0
Original line number Diff line number Diff line
@@ -35,6 +35,7 @@ import android.annotation.IntRange; 
import android.annotation.NonNull;

import android.annotation.Nullable;

import android.annotation.UnsupportedAppUsage;

import android.content.Intent;

import android.graphics.Insets;

import android.graphics.Rect;

import android.util.SparseArray;
@@ -644,6 +645,14 @@ public final class WindowInsets { 
     * {@link View#setSystemGestureExclusionRects} outside of the

     * {@link #getMandatorySystemGestureInsets() mandatory system gesture insets}.

     *

     * <p>Note: the system will put a limit of <code>200dp</code> on the vertical extent of the

     * exclusions it takes into account. The limit does not apply while the navigation

     * bar is {@link View#SYSTEM_UI_FLAG_IMMERSIVE_STICKY stickily} hidden, nor to the

     * {@link android.inputmethodservice.InputMethodService input method} and

     * {@link Intent#CATEGORY_HOME home activity}.

     * </p>

     *

     *

     * <p>Simple taps are guaranteed to reach the window even within the system gesture insets,

     * as long as they are outside the {@link #getTappableElementInsets() system window insets}.

     *