diff options
author | Adrian Roos <roosa@google.com> | 2019-08-02 12:17:11 +0000 |
---|---|---|
committer | Android (Google) Code Review <android-gerrit@google.com> | 2019-08-02 12:17:11 +0000 |
commit | c9f4bcae570a02fbbd4e5af6d7cf7cca00200520 (patch) | |
tree | 9df3a71b81723bfef808574e62960ebece2597bc | |
parent | 7bb64fcf278a026a5b32fdc33c02b0292c8119dc (diff) | |
parent | e6feb7d19842c3fe0c3f45a4ddfdc430fa822ee1 (diff) | |
download | base-c9f4bcae570a02fbbd4e5af6d7cf7cca00200520.tar.gz |
Merge "GestureNav: Clarify javadoc in regards to exclusion limits" into qt-dev
-rw-r--r-- | core/java/android/view/View.java | 7 | ||||
-rw-r--r-- | core/java/android/view/WindowInsets.java | 9 |
2 files changed, 16 insertions, 0 deletions
diff --git a/core/java/android/view/View.java b/core/java/android/view/View.java index 1275e46ed421..e3db475d6681 100644 --- a/core/java/android/view/View.java +++ b/core/java/android/view/View.java @@ -10571,6 +10571,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) { diff --git a/core/java/android/view/WindowInsets.java b/core/java/android/view/WindowInsets.java index 9340b71a5280..bcc6a552f569 100644 --- a/core/java/android/view/WindowInsets.java +++ b/core/java/android/view/WindowInsets.java @@ -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}. * |