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

Commit 4337778f 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... 

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

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



Change-Id: I2a1177dd464c277e8c5332169fe286cec48c7848
Ignore-AOSP-First: this is an automerge
Signed-off-by: default avatarAutomerger Merge Worker <android-build-automerger-merge-worker@system.gserviceaccount.com>
parents 61f8a689 9aa676cf

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