/* * 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 android.graphics.Point; import android.support.v7.widget.RecyclerView; 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 final MotionEvent mEvent; private final int mPosition; public MotionInputEvent(MotionEvent event, RecyclerView view) { mEvent = event; // Consider determining position lazily as an optimization. View child = view.findChildViewUnder(mEvent.getX(), mEvent.getY()); mPosition = (child!= null) ? view.getChildAdapterPosition(child) : RecyclerView.NO_POSITION; } @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(); } } }