Merge "Advise use of InputDeviceListener when using pointer capture" into tm-dev am: b49c8b3a3a

Original change: https://googleplex-android-review.googlesource.com/c/platform/frameworks/base/+/17756693

Change-Id: I7c40509113e1767d8e4cbd111ad1412f1781b716
Ignore-AOSP-First: this is an automerge
Signed-off-by: Automerger Merge Worker <android-build-automerger-merge-worker@system.gserviceaccount.com>
This commit is contained in:
TreeHugger Robot
2022-04-25 12:08:55 +00:00
committed by Automerger Merge Worker

View File

@@ -28733,7 +28733,7 @@ public class View implements Drawable.Callback, KeyEvent.Callback,
* {@link InputDevice#SOURCE_MOUSE_RELATIVE}, and relative position changes will be
* available through {@link MotionEvent#getX} and {@link MotionEvent#getY}.</li>
*
* <li>Events from a touchpad will be delivered with the source
* <li>Events from a touchpad or trackpad will be delivered with the source
* {@link InputDevice#SOURCE_TOUCHPAD}, where the absolute position of each of the pointers
* on the touchpad will be available through {@link MotionEvent#getX(int)} and
* {@link MotionEvent#getY(int)}, and their relative movements are stored in
@@ -28742,6 +28742,12 @@ public class View implements Drawable.Callback, KeyEvent.Callback,
* <li>Events from other types of devices, such as touchscreens, will not be affected.</li>
* </ul>
* <p>
* When pointer capture changes, connected mouse and trackpad devices may be reconfigured,
* and their properties (such as their sources or motion ranges) may change. Use an
* {@link android.hardware.input.InputManager.InputDeviceListener} to be notified when a device
* changes (which may happen after enabling or disabling pointer capture), and use
* {@link InputDevice#getDevice(int)} to get the updated {@link InputDevice}.
* <p>
* Events captured through pointer capture will be dispatched to
* {@link OnCapturedPointerListener#onCapturedPointer(View, MotionEvent)} if an
* {@link OnCapturedPointerListener} is set, and otherwise to