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

Commit 9aa676cf authored by TreeHugger Robot's avatar TreeHugger Robot Committed by Automerger Merge Worker
Browse files

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

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: default avatarAutomerger Merge Worker <android-build-automerger-merge-worker@system.gserviceaccount.com>
parents ee95f5a4 b49c8b3a

core/java/android/view/View.java

+7 −1
Original line number Diff line number Diff line
@@ -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