Merge "GestureNav: Clarify javadoc in regards to exclusion limits" into qt-dev

This commit is contained in:
Adrian Roos
2019-08-02 12:17:11 +00:00
committed by Android (Google) Code Review
2 changed files with 16 additions and 0 deletions

View File

@@ -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) {

View File

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