/* * Copyright (C) 2015 The Android Open Source Project * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ package com.android.documentsui; import static com.android.documentsui.Shared.DEBUG; import android.graphics.Point; import android.os.Looper; import android.support.v7.widget.RecyclerView; import android.util.Log; import android.util.Pools; import android.view.KeyEvent; import android.view.MotionEvent; import android.view.View; /** * Utility code for dealing with MotionEvents. */ public final class Events { /** * Returns true if event was triggered by a mouse. */ public static boolean isMouseEvent(MotionEvent e) { return isMouseType(e.getToolType(0)); } /** * Returns true if event was triggered by a finger or stylus touch. */ public static boolean isTouchEvent(MotionEvent e) { return isTouchType(e.getToolType(0)); } /** * Returns true if event was triggered by a mouse. */ public static boolean isMouseType(int toolType) { return toolType == MotionEvent.TOOL_TYPE_MOUSE; } /** * Returns true if event was triggered by a finger or stylus touch. */ public static boolean isTouchType(int toolType) { return toolType == MotionEvent.TOOL_TYPE_FINGER || toolType == MotionEvent.TOOL_TYPE_STYLUS; } /** * Returns true if event was triggered by a finger or stylus touch. */ public static boolean isActionDown(MotionEvent e) { return e.getActionMasked() == MotionEvent.ACTION_DOWN; } /** * Returns true if event was triggered by a finger or stylus touch. */ public static boolean isActionUp(MotionEvent e) { return e.getActionMasked() == MotionEvent.ACTION_UP; } /** * Returns true if the shift is pressed. */ public boolean isShiftPressed(MotionEvent e) { return hasShiftBit(e.getMetaState()); } /** * Whether or not the given keyCode represents a navigation keystroke (e.g. up, down, home). * * @param keyCode * @return */ public static boolean isNavigationKeyCode(int keyCode) { switch (keyCode) { case KeyEvent.KEYCODE_DPAD_UP: case KeyEvent.KEYCODE_DPAD_DOWN: case KeyEvent.KEYCODE_DPAD_LEFT: case KeyEvent.KEYCODE_DPAD_RIGHT: case KeyEvent.KEYCODE_MOVE_HOME: case KeyEvent.KEYCODE_MOVE_END: case KeyEvent.KEYCODE_PAGE_UP: case KeyEvent.KEYCODE_PAGE_DOWN: return true; default: return false; } } /** * Returns true if the "SHIFT" bit is set. */ public static boolean hasShiftBit(int metaState) { return (metaState & KeyEvent.META_SHIFT_ON) != 0; } /** * A facade over MotionEvent primarily designed to permit for unit testing * of related code. */ public interface InputEvent { boolean isMouseEvent(); boolean isPrimaryButtonPressed(); boolean isSecondaryButtonPressed(); boolean isShiftKeyDown(); /** Returns true if the action is the initial press of a mouse or touch. */ boolean isActionDown(); /** Returns true if the action is the final release of a mouse or touch. */ boolean isActionUp(); Point getOrigin(); /** Returns true if the there is an item under the finger/cursor. */ boolean isOverItem(); /** Returns the adapter position of the item under the finger/cursor. */ int getItemPosition(); } public static final class MotionInputEvent implements InputEvent { private static final String TAG = "MotionInputEvent"; private static final Pools.SimplePool sPool = new Pools.SimplePool<>(1); private MotionEvent mEvent; private int mPosition; private MotionInputEvent() { if (DEBUG) Log.i(TAG, "Created a new instance."); } public static MotionInputEvent obtain(MotionEvent event, RecyclerView view) { // Make sure events are only used in main thread. assert(Looper.myLooper() == Looper.getMainLooper()); MotionInputEvent instance = sPool.acquire(); instance = (instance != null ? instance : new MotionInputEvent()); instance.mEvent = event; // Consider determining position lazily as an optimization. View child = view.findChildViewUnder(event.getX(), event.getY()); instance.mPosition = (child != null) ? view.getChildAdapterPosition(child) : RecyclerView.NO_POSITION; return instance; } public void recycle() { // Make sure events are only used in main thread. assert(Looper.myLooper() == Looper.getMainLooper()); mEvent = null; mPosition = -1; boolean released = sPool.release(this); // This assert is used to guarantee we won't generate too many instances that can't be // held in the pool, which indicates our pool size is too small. // // Right now one instance is enough because we expect all instances are only used in // main thread. assert(released); } @Override public boolean isMouseEvent() { return Events.isMouseEvent(mEvent); } @Override public boolean isPrimaryButtonPressed() { return mEvent.isButtonPressed(MotionEvent.BUTTON_PRIMARY); } @Override public boolean isSecondaryButtonPressed() { return mEvent.isButtonPressed(MotionEvent.BUTTON_SECONDARY); } @Override public boolean isShiftKeyDown() { return Events.hasShiftBit(mEvent.getMetaState()); } @Override public boolean isActionDown() { return mEvent.getActionMasked() == MotionEvent.ACTION_DOWN; } @Override public boolean isActionUp() { return mEvent.getActionMasked() == MotionEvent.ACTION_UP; } @Override public Point getOrigin() { return new Point((int) mEvent.getX(), (int) mEvent.getY()); } @Override public boolean isOverItem() { return getItemPosition() != RecyclerView.NO_POSITION; } @Override public int getItemPosition() { return mPosition; } @Override public String toString() { return new StringBuilder() .append("MotionInputEvent {") .append("isMouseEvent=").append(isMouseEvent()) .append(" isPrimaryButtonPressed=").append(isPrimaryButtonPressed()) .append(" isSecondaryButtonPressed=").append(isSecondaryButtonPressed()) .append(" isShiftKeyDown=").append(isShiftKeyDown()) .append(" isActionDown=").append(isActionDown()) .append(" isActionUp=").append(isActionUp()) .append(" getOrigin=").append(getOrigin()) .append(" isOverItem=").append(isOverItem()) .append(" getItemPosition=").append(getItemPosition()) .append("}") .toString(); } } }