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

Commit 3787de16 authored by Vladislav Kaznacheev's avatar Vladislav Kaznacheev
Browse files

Implement pointer capture API 

When in pointer capture mode, mouse pointer disappears and
further mouse events are dispatched to the focused view
in the window which has requested capture.

The captured events have the source SOURCE_MOUSE_RELATIVE
belonging to SOURCE_CLASS_TRACKBALL. They are
dispatched through dispatchCapturedPointerEvent /
onCapturedPointerEvent. There is also a new listener.

Pointer capture mode may only be granted to a currently
focused window, and will be canceled upon a window focus change.

Test: cts-tradefed ... --test android.view.cts.PointerCaptureTest
Bug: 30897034
Change-Id: I6e5934aa415ac2b6dda1cee173d0f23e5021af84
parent 73c945de

api/current.txt

+14 −0
Original line number Diff line number Diff line
@@ -42663,6 +42663,7 @@ package android.view { 
    field public static final int SOURCE_JOYSTICK = 16777232; // 0x1000010

    field public static final int SOURCE_KEYBOARD = 257; // 0x101

    field public static final int SOURCE_MOUSE = 8194; // 0x2002

    field public static final int SOURCE_MOUSE_RELATIVE = 131076; // 0x20004

    field public static final int SOURCE_STYLUS = 16386; // 0x4002

    field public static final int SOURCE_TOUCHPAD = 1048584; // 0x100008

    field public static final int SOURCE_TOUCHSCREEN = 4098; // 0x1002
@@ -43817,6 +43818,7 @@ package android.view { 
    method public void createContextMenu(android.view.ContextMenu);

    method public void destroyDrawingCache();

    method public android.view.WindowInsets dispatchApplyWindowInsets(android.view.WindowInsets);

    method public boolean dispatchCapturedPointerEvent(android.view.MotionEvent);

    method public void dispatchConfigurationChanged(android.content.res.Configuration);

    method public void dispatchDisplayHint(int);

    method public boolean dispatchDragEvent(android.view.DragEvent);
@@ -43835,6 +43837,7 @@ package android.view { 
    method public boolean dispatchNestedPrePerformAccessibilityAction(int, android.os.Bundle);

    method public boolean dispatchNestedPreScroll(int, int, int[], int[]);

    method public boolean dispatchNestedScroll(int, int, int, int, int[]);

    method public void dispatchPointerCaptureChanged(boolean);

    method public boolean dispatchPopulateAccessibilityEvent(android.view.accessibility.AccessibilityEvent);

    method public void dispatchProvideAutoFillStructure(android.view.ViewStructure, int);

    method public void dispatchProvideStructure(android.view.ViewStructure);
@@ -44017,6 +44020,7 @@ package android.view { 
    method public boolean hasNestedScrollingParent();

    method public boolean hasOnClickListeners();

    method public boolean hasOverlappingRendering();

    method public boolean hasPointerCapture();

    method public boolean hasTransientState();

    method public boolean hasWindowFocus();

    method public static android.view.View inflate(android.content.Context, int, android.view.ViewGroup);
@@ -44081,6 +44085,7 @@ package android.view { 
    method public android.view.WindowInsets onApplyWindowInsets(android.view.WindowInsets);

    method protected void onAttachedToWindow();

    method public void onCancelPendingInputEvents();

    method public boolean onCapturedPointerEvent(android.view.MotionEvent);

    method public boolean onCheckIsTextEditor();

    method protected void onConfigurationChanged(android.content.res.Configuration);

    method protected void onCreateContextMenu(android.view.ContextMenu);
@@ -44110,6 +44115,7 @@ package android.view { 
    method protected void onLayout(boolean, int, int, int, int);

    method protected void onMeasure(int, int);

    method protected void onOverScrolled(int, int, boolean, boolean);

    method public void onPointerCaptureChange(boolean);

    method public void onPopulateAccessibilityEvent(android.view.accessibility.AccessibilityEvent);

    method public void onProvideAutoFillStructure(android.view.ViewStructure, int);

    method public void onProvideAutoFillVirtualStructure(android.view.ViewStructure, int);
@@ -44152,6 +44158,7 @@ package android.view { 
    method public void postOnAnimation(java.lang.Runnable);

    method public void postOnAnimationDelayed(java.lang.Runnable, long);

    method public void refreshDrawableState();

    method public void releasePointerCapture();

    method public boolean removeCallbacks(java.lang.Runnable);

    method public void removeOnAttachStateChangeListener(android.view.View.OnAttachStateChangeListener);

    method public void removeOnLayoutChangeListener(android.view.View.OnLayoutChangeListener);
@@ -44162,6 +44169,7 @@ package android.view { 
    method public boolean requestFocus(int, android.graphics.Rect);

    method public final boolean requestFocusFromTouch();

    method public void requestLayout();

    method public void requestPointerCapture();

    method public boolean requestRectangleOnScreen(android.graphics.Rect);

    method public boolean requestRectangleOnScreen(android.graphics.Rect, boolean);

    method public final void requestUnbufferedDispatch(android.view.MotionEvent);
@@ -44239,6 +44247,7 @@ package android.view { 
    method public void setNextFocusRightId(int);

    method public void setNextFocusUpId(int);

    method public void setOnApplyWindowInsetsListener(android.view.View.OnApplyWindowInsetsListener);

    method public void setOnCapturedPointerListener(android.view.View.OnCapturedPointerListener);

    method public void setOnClickListener(android.view.View.OnClickListener);

    method public void setOnContextClickListener(android.view.View.OnContextClickListener);

    method public void setOnCreateContextMenuListener(android.view.View.OnCreateContextMenuListener);
@@ -44512,6 +44521,10 @@ package android.view { 
    method public abstract void onViewDetachedFromWindow(android.view.View);

  }













  public static abstract interface View.OnCapturedPointerListener {













    method public abstract boolean onCapturedPointer(android.view.View, android.view.MotionEvent);













  }



























  public static abstract interface View.OnClickListener {















    method public abstract void onClick(android.view.View);















  }










@@ -45244,6 +45257,7 @@ package android.view {













    method public abstract boolean onMenuItemSelected(int, android.view.MenuItem);















    method public abstract boolean onMenuOpened(int, android.view.Menu);















    method public abstract void onPanelClosed(int, android.view.Menu);













    method public default void onPointerCaptureChanged(boolean);















    method public abstract boolean onPreparePanel(int, android.view.View, android.view.Menu);















    method public default void onProvideKeyboardShortcuts(java.util.List<android.view.KeyboardShortcutGroup>, android.view.Menu, int);















    method public abstract boolean onSearchRequested();

























api/system-current.txt



+14
−0




























Original line number
Diff line number
Diff line








@@ -46045,6 +46045,7 @@ package android.view {













    field public static final int SOURCE_JOYSTICK = 16777232; // 0x1000010















    field public static final int SOURCE_KEYBOARD = 257; // 0x101















    field public static final int SOURCE_MOUSE = 8194; // 0x2002













    field public static final int SOURCE_MOUSE_RELATIVE = 131076; // 0x20004















    field public static final int SOURCE_STYLUS = 16386; // 0x4002















    field public static final int SOURCE_TOUCHPAD = 1048584; // 0x100008















    field public static final int SOURCE_TOUCHSCREEN = 4098; // 0x1002










@@ -47199,6 +47200,7 @@ package android.view {













    method public void createContextMenu(android.view.ContextMenu);















    method public void destroyDrawingCache();















    method public android.view.WindowInsets dispatchApplyWindowInsets(android.view.WindowInsets);













    method public boolean dispatchCapturedPointerEvent(android.view.MotionEvent);















    method public void dispatchConfigurationChanged(android.content.res.Configuration);















    method public void dispatchDisplayHint(int);















    method public boolean dispatchDragEvent(android.view.DragEvent);









@@ -47217,6 +47219,7 @@ package android.view {













    method public boolean dispatchNestedPrePerformAccessibilityAction(int, android.os.Bundle);















    method public boolean dispatchNestedPreScroll(int, int, int[], int[]);















    method public boolean dispatchNestedScroll(int, int, int, int, int[]);













    method public void dispatchPointerCaptureChanged(boolean);















    method public boolean dispatchPopulateAccessibilityEvent(android.view.accessibility.AccessibilityEvent);















    method public void dispatchProvideAutoFillStructure(android.view.ViewStructure, int);















    method public void dispatchProvideStructure(android.view.ViewStructure);










@@ -47399,6 +47402,7 @@ package android.view {













    method public boolean hasNestedScrollingParent();















    method public boolean hasOnClickListeners();















    method public boolean hasOverlappingRendering();













    method public boolean hasPointerCapture();















    method public boolean hasTransientState();















    method public boolean hasWindowFocus();















    method public static android.view.View inflate(android.content.Context, int, android.view.ViewGroup);










@@ -47463,6 +47467,7 @@ package android.view {













    method public android.view.WindowInsets onApplyWindowInsets(android.view.WindowInsets);















    method protected void onAttachedToWindow();















    method public void onCancelPendingInputEvents();













    method public boolean onCapturedPointerEvent(android.view.MotionEvent);















    method public boolean onCheckIsTextEditor();















    method protected void onConfigurationChanged(android.content.res.Configuration);















    method protected void onCreateContextMenu(android.view.ContextMenu);










@@ -47492,6 +47497,7 @@ package android.view {













    method protected void onLayout(boolean, int, int, int, int);















    method protected void onMeasure(int, int);















    method protected void onOverScrolled(int, int, boolean, boolean);













    method public void onPointerCaptureChange(boolean);















    method public void onPopulateAccessibilityEvent(android.view.accessibility.AccessibilityEvent);















    method public void onProvideAutoFillStructure(android.view.ViewStructure, int);















    method public void onProvideAutoFillVirtualStructure(android.view.ViewStructure, int);










@@ -47534,6 +47540,7 @@ package android.view {













    method public void postOnAnimation(java.lang.Runnable);















    method public void postOnAnimationDelayed(java.lang.Runnable, long);















    method public void refreshDrawableState();













    method public void releasePointerCapture();















    method public boolean removeCallbacks(java.lang.Runnable);















    method public void removeOnAttachStateChangeListener(android.view.View.OnAttachStateChangeListener);















    method public void removeOnLayoutChangeListener(android.view.View.OnLayoutChangeListener);









@@ -47544,6 +47551,7 @@ package android.view {













    method public boolean requestFocus(int, android.graphics.Rect);















    method public final boolean requestFocusFromTouch();















    method public void requestLayout();













    method public void requestPointerCapture();















    method public boolean requestRectangleOnScreen(android.graphics.Rect);















    method public boolean requestRectangleOnScreen(android.graphics.Rect, boolean);















    method public final void requestUnbufferedDispatch(android.view.MotionEvent);










@@ -47621,6 +47629,7 @@ package android.view {













    method public void setNextFocusRightId(int);















    method public void setNextFocusUpId(int);















    method public void setOnApplyWindowInsetsListener(android.view.View.OnApplyWindowInsetsListener);













    method public void setOnCapturedPointerListener(android.view.View.OnCapturedPointerListener);















    method public void setOnClickListener(android.view.View.OnClickListener);















    method public void setOnContextClickListener(android.view.View.OnContextClickListener);















    method public void setOnCreateContextMenuListener(android.view.View.OnCreateContextMenuListener);










@@ -47894,6 +47903,10 @@ package android.view {













    method public abstract void onViewDetachedFromWindow(android.view.View);















  }



























  public static abstract interface View.OnCapturedPointerListener {













    method public abstract boolean onCapturedPointer(android.view.View, android.view.MotionEvent);













  }



























  public static abstract interface View.OnClickListener {















    method public abstract void onClick(android.view.View);















  }










@@ -48627,6 +48640,7 @@ package android.view {













    method public abstract boolean onMenuItemSelected(int, android.view.MenuItem);















    method public abstract boolean onMenuOpened(int, android.view.Menu);















    method public abstract void onPanelClosed(int, android.view.Menu);













    method public default void onPointerCaptureChanged(boolean);















    method public abstract boolean onPreparePanel(int, android.view.View, android.view.Menu);















    method public default void onProvideKeyboardShortcuts(java.util.List<android.view.KeyboardShortcutGroup>, android.view.Menu, int);















    method public abstract boolean onSearchRequested();

























api/test-current.txt



+14
−0




























Original line number
Diff line number
Diff line








@@ -42964,6 +42964,7 @@ package android.view {













    field public static final int SOURCE_JOYSTICK = 16777232; // 0x1000010















    field public static final int SOURCE_KEYBOARD = 257; // 0x101















    field public static final int SOURCE_MOUSE = 8194; // 0x2002













    field public static final int SOURCE_MOUSE_RELATIVE = 131076; // 0x20004















    field public static final int SOURCE_STYLUS = 16386; // 0x4002















    field public static final int SOURCE_TOUCHPAD = 1048584; // 0x100008















    field public static final int SOURCE_TOUCHSCREEN = 4098; // 0x1002










@@ -44120,6 +44121,7 @@ package android.view {













    method public void createContextMenu(android.view.ContextMenu);















    method public void destroyDrawingCache();















    method public android.view.WindowInsets dispatchApplyWindowInsets(android.view.WindowInsets);













    method public boolean dispatchCapturedPointerEvent(android.view.MotionEvent);















    method public void dispatchConfigurationChanged(android.content.res.Configuration);















    method public void dispatchDisplayHint(int);















    method public boolean dispatchDragEvent(android.view.DragEvent);









@@ -44138,6 +44140,7 @@ package android.view {













    method public boolean dispatchNestedPrePerformAccessibilityAction(int, android.os.Bundle);















    method public boolean dispatchNestedPreScroll(int, int, int[], int[]);















    method public boolean dispatchNestedScroll(int, int, int, int, int[]);













    method public void dispatchPointerCaptureChanged(boolean);















    method public boolean dispatchPopulateAccessibilityEvent(android.view.accessibility.AccessibilityEvent);















    method public void dispatchProvideAutoFillStructure(android.view.ViewStructure, int);















    method public void dispatchProvideStructure(android.view.ViewStructure);










@@ -44321,6 +44324,7 @@ package android.view {













    method public boolean hasNestedScrollingParent();















    method public boolean hasOnClickListeners();















    method public boolean hasOverlappingRendering();













    method public boolean hasPointerCapture();















    method public boolean hasTransientState();















    method public boolean hasWindowFocus();















    method public static android.view.View inflate(android.content.Context, int, android.view.ViewGroup);










@@ -44385,6 +44389,7 @@ package android.view {













    method public android.view.WindowInsets onApplyWindowInsets(android.view.WindowInsets);















    method protected void onAttachedToWindow();















    method public void onCancelPendingInputEvents();













    method public boolean onCapturedPointerEvent(android.view.MotionEvent);















    method public boolean onCheckIsTextEditor();















    method protected void onConfigurationChanged(android.content.res.Configuration);















    method protected void onCreateContextMenu(android.view.ContextMenu);










@@ -44414,6 +44419,7 @@ package android.view {













    method protected void onLayout(boolean, int, int, int, int);















    method protected void onMeasure(int, int);















    method protected void onOverScrolled(int, int, boolean, boolean);













    method public void onPointerCaptureChange(boolean);















    method public void onPopulateAccessibilityEvent(android.view.accessibility.AccessibilityEvent);















    method public void onProvideAutoFillStructure(android.view.ViewStructure, int);















    method public void onProvideAutoFillVirtualStructure(android.view.ViewStructure, int);










@@ -44456,6 +44462,7 @@ package android.view {













    method public void postOnAnimation(java.lang.Runnable);















    method public void postOnAnimationDelayed(java.lang.Runnable, long);















    method public void refreshDrawableState();













    method public void releasePointerCapture();















    method public boolean removeCallbacks(java.lang.Runnable);















    method public void removeOnAttachStateChangeListener(android.view.View.OnAttachStateChangeListener);















    method public void removeOnLayoutChangeListener(android.view.View.OnLayoutChangeListener);









@@ -44466,6 +44473,7 @@ package android.view {













    method public boolean requestFocus(int, android.graphics.Rect);















    method public final boolean requestFocusFromTouch();















    method public void requestLayout();













    method public void requestPointerCapture();















    method public boolean requestRectangleOnScreen(android.graphics.Rect);















    method public boolean requestRectangleOnScreen(android.graphics.Rect, boolean);















    method public final void requestUnbufferedDispatch(android.view.MotionEvent);










@@ -44543,6 +44551,7 @@ package android.view {













    method public void setNextFocusRightId(int);















    method public void setNextFocusUpId(int);















    method public void setOnApplyWindowInsetsListener(android.view.View.OnApplyWindowInsetsListener);













    method public void setOnCapturedPointerListener(android.view.View.OnCapturedPointerListener);















    method public void setOnClickListener(android.view.View.OnClickListener);















    method public void setOnContextClickListener(android.view.View.OnContextClickListener);















    method public void setOnCreateContextMenuListener(android.view.View.OnCreateContextMenuListener);










@@ -44816,6 +44825,10 @@ package android.view {













    method public abstract void onViewDetachedFromWindow(android.view.View);















  }



























  public static abstract interface View.OnCapturedPointerListener {













    method public abstract boolean onCapturedPointer(android.view.View, android.view.MotionEvent);













  }



























  public static abstract interface View.OnClickListener {















    method public abstract void onClick(android.view.View);















  }










@@ -45552,6 +45565,7 @@ package android.view {













    method public abstract boolean onMenuItemSelected(int, android.view.MenuItem);















    method public abstract boolean onMenuOpened(int, android.view.Menu);















    method public abstract void onPanelClosed(int, android.view.Menu);













    method public default void onPointerCaptureChanged(boolean);















    method public abstract boolean onPreparePanel(int, android.view.View, android.view.Menu);















    method public default void onProvideKeyboardShortcuts(java.util.List<android.view.KeyboardShortcutGroup>, android.view.Menu, int);















    method public abstract boolean onSearchRequested();

























core/java/android/hardware/input/IInputManager.aidl



+2
−0




























Original line number
Diff line number
Diff line








@@ -81,4 +81,6 @@ interface IInputManager {





























    void setPointerIconType(int typeId);















    void setCustomPointerIcon(in PointerIcon icon);



























    void requestPointerCapture(IBinder windowToken, boolean enabled);















}
























core/java/android/hardware/input/InputManager.java



+20
−0




























Original line number
Diff line number
Diff line








@@ -40,6 +40,7 @@ import android.util.Log;













import android.util.SparseArray;















import android.view.InputDevice;















import android.view.InputEvent;













import android.view.MotionEvent;















import android.view.PointerIcon;















import android.view.inputmethod.InputMethodInfo;















import android.view.inputmethod.InputMethodSubtype;










@@ -898,6 +899,25 @@ public final class InputManager {













        }















    }





























    /**













     * Request or release pointer capture.













     * <p>













     * When in capturing mode, the pointer icon disappears and all mouse events are dispatched to













     * the window which has requested the capture. Relative position changes are available through













     * {@link MotionEvent#getX} and {@link MotionEvent#getY}.













     *













     * @param enable true when requesting pointer capture, false when releasing.













     *













     * @hide













     */













    public void requestPointerCapture(IBinder windowToken, boolean enable) {













        try {













            mIm.requestPointerCapture(windowToken, enable);













        } catch (RemoteException ex) {













            throw ex.rethrowFromSystemServer();













        }













    }





























    private void populateInputDevicesLocked() {















        if (mInputDevicesChangedListener == null) {















            final InputDevicesChangedListener listener = new InputDevicesChangedListener();