From f1cd9e468ce731b20aff45236c6d75c0424c53a0 Mon Sep 17 00:00:00 2001
From: Antonio Kantek <kanant@google.com>
Date: Fri, 7 Oct 2022 01:31:42 +0000
Subject: [PATCH] Update View#isInTouchMode javadoc

Update View#isInTouchMode javadoc according to the new multi-display
touch mode implementation.

Bug: 198499018
Test: m
Change-Id: Idb6cbadd3afd745b76690de67c363749c810f06e
---
 core/java/android/view/View.java | 13 +++++++------
 1 file changed, 7 insertions(+), 6 deletions(-)

diff --git a/core/java/android/view/View.java b/core/java/android/view/View.java
index bc665cf09652c..331aa59a2fd84 100644
--- a/core/java/android/view/View.java
+++ b/core/java/android/view/View.java
@@ -15903,15 +15903,16 @@ public class View implements Drawable.Callback, KeyEvent.Callback,
     }
 
     /**
-     * Returns whether the device is currently in touch mode. Touch mode is entered
-     * once the user begins interacting with the device by touch, and affects various
-     * things like whether focus is always visible to the user.
+     * Returns the touch mode state associated with this view.
      *
-     * If this view has no {@link ViewRootImpl} or {@link Display} attached, then it will return
-     * the default touch mode value defined in
+     * Attached views return the touch mode state from the associated window's display.
+     * Detached views just return the default touch mode value defined in
      * {@code com.android.internal.R.bool.config_defaultInTouchMode}.
      *
-     * @return Whether the device is in touch mode.
+     * Touch mode is entered once the user begins interacting with the device by touch, and
+     * affects various things like whether focus highlight is always visible to the user.
+     *
+     * @return the touch mode state associated with this view
      */
     @ViewDebug.ExportedProperty
     public boolean isInTouchMode() {