107be125b91f110b30f5f958e217368fc5f7e4b31Steve McKay/* 207be125b91f110b30f5f958e217368fc5f7e4b31Steve McKay * Copyright (C) 2016 The Android Open Source Project 307be125b91f110b30f5f958e217368fc5f7e4b31Steve McKay * 407be125b91f110b30f5f958e217368fc5f7e4b31Steve McKay * Licensed under the Apache License, Version 2.0 (the "License"); 507be125b91f110b30f5f958e217368fc5f7e4b31Steve McKay * you may not use this file except in compliance with the License. 607be125b91f110b30f5f958e217368fc5f7e4b31Steve McKay * You may obtain a copy of the License at 707be125b91f110b30f5f958e217368fc5f7e4b31Steve McKay * 807be125b91f110b30f5f958e217368fc5f7e4b31Steve McKay * http://www.apache.org/licenses/LICENSE-2.0 907be125b91f110b30f5f958e217368fc5f7e4b31Steve McKay * 1007be125b91f110b30f5f958e217368fc5f7e4b31Steve McKay * Unless required by applicable law or agreed to in writing, software 1107be125b91f110b30f5f958e217368fc5f7e4b31Steve McKay * distributed under the License is distributed on an "AS IS" BASIS, 1207be125b91f110b30f5f958e217368fc5f7e4b31Steve McKay * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 1307be125b91f110b30f5f958e217368fc5f7e4b31Steve McKay * See the License for the specific language governing permissions and 1407be125b91f110b30f5f958e217368fc5f7e4b31Steve McKay * limitations under the License. 1507be125b91f110b30f5f958e217368fc5f7e4b31Steve McKay */ 1607be125b91f110b30f5f958e217368fc5f7e4b31Steve McKay 170aa720752bc87d2d387b41a3016f0d533a8fc7f1Steve McKaypackage com.android.documentsui.selection; 1807be125b91f110b30f5f958e217368fc5f7e4b31Steve McKay 195bf51ec2ce8ba84ab56ab866ac8539c42d87a2f0Steve McKayimport static android.support.v4.util.Preconditions.checkArgument; 205bf51ec2ce8ba84ab56ab866ac8539c42d87a2f0Steve McKay 2107be125b91f110b30f5f958e217368fc5f7e4b31Steve McKayimport android.support.v7.widget.RecyclerView; 2207be125b91f110b30f5f958e217368fc5f7e4b31Steve McKayimport android.support.v7.widget.RecyclerView.OnItemTouchListener; 2307be125b91f110b30f5f958e217368fc5f7e4b31Steve McKayimport android.view.GestureDetector; 2407be125b91f110b30f5f958e217368fc5f7e4b31Steve McKayimport android.view.MotionEvent; 2507be125b91f110b30f5f958e217368fc5f7e4b31Steve McKay 2607be125b91f110b30f5f958e217368fc5f7e4b31Steve McKay/** 275bf51ec2ce8ba84ab56ab866ac8539c42d87a2f0Steve McKay * A class responsible for routing MotionEvents to tool-type specific handlers, 285bf51ec2ce8ba84ab56ab866ac8539c42d87a2f0Steve McKay * and if not handled by a handler, on to a {@link GestureDetector} for further 295bf51ec2ce8ba84ab56ab866ac8539c42d87a2f0Steve McKay * processing. 305bf51ec2ce8ba84ab56ab866ac8539c42d87a2f0Steve McKay * 315bf51ec2ce8ba84ab56ab866ac8539c42d87a2f0Steve McKay * <p>TouchEventRouter takes its name from 325bf51ec2ce8ba84ab56ab866ac8539c42d87a2f0Steve McKay * {@link RecyclerView#addOnItemTouchListener(OnItemTouchListener)}. Despite "Touch" 335bf51ec2ce8ba84ab56ab866ac8539c42d87a2f0Steve McKay * being in the name, it receives MotionEvents for all types of tools. 3407be125b91f110b30f5f958e217368fc5f7e4b31Steve McKay */ 3507be125b91f110b30f5f958e217368fc5f7e4b31Steve McKaypublic final class TouchEventRouter implements OnItemTouchListener { 3607be125b91f110b30f5f958e217368fc5f7e4b31Steve McKay 3707be125b91f110b30f5f958e217368fc5f7e4b31Steve McKay private final GestureDetector mDetector; 3807be125b91f110b30f5f958e217368fc5f7e4b31Steve McKay private final ToolHandlerRegistry<OnItemTouchListener> mDelegates; 3907be125b91f110b30f5f958e217368fc5f7e4b31Steve McKay 4007be125b91f110b30f5f958e217368fc5f7e4b31Steve McKay public TouchEventRouter(GestureDetector detector, OnItemTouchListener defaultDelegate) { 415bf51ec2ce8ba84ab56ab866ac8539c42d87a2f0Steve McKay checkArgument(detector != null); 425bf51ec2ce8ba84ab56ab866ac8539c42d87a2f0Steve McKay checkArgument(defaultDelegate != null); 435bf51ec2ce8ba84ab56ab866ac8539c42d87a2f0Steve McKay 4407be125b91f110b30f5f958e217368fc5f7e4b31Steve McKay mDetector = detector; 4507be125b91f110b30f5f958e217368fc5f7e4b31Steve McKay mDelegates = new ToolHandlerRegistry<>(defaultDelegate); 4607be125b91f110b30f5f958e217368fc5f7e4b31Steve McKay } 4707be125b91f110b30f5f958e217368fc5f7e4b31Steve McKay 4807be125b91f110b30f5f958e217368fc5f7e4b31Steve McKay public TouchEventRouter(GestureDetector detector) { 4907be125b91f110b30f5f958e217368fc5f7e4b31Steve McKay this( 5007be125b91f110b30f5f958e217368fc5f7e4b31Steve McKay detector, 5107be125b91f110b30f5f958e217368fc5f7e4b31Steve McKay // Default listener does nothing. 5207be125b91f110b30f5f958e217368fc5f7e4b31Steve McKay new OnItemTouchListener() { 5307be125b91f110b30f5f958e217368fc5f7e4b31Steve McKay @Override 5407be125b91f110b30f5f958e217368fc5f7e4b31Steve McKay public boolean onInterceptTouchEvent(RecyclerView rv, MotionEvent e) { 5507be125b91f110b30f5f958e217368fc5f7e4b31Steve McKay return false; 5607be125b91f110b30f5f958e217368fc5f7e4b31Steve McKay } 5707be125b91f110b30f5f958e217368fc5f7e4b31Steve McKay 5807be125b91f110b30f5f958e217368fc5f7e4b31Steve McKay @Override 5907be125b91f110b30f5f958e217368fc5f7e4b31Steve McKay public void onTouchEvent(RecyclerView rv, MotionEvent e) { 6007be125b91f110b30f5f958e217368fc5f7e4b31Steve McKay } 6107be125b91f110b30f5f958e217368fc5f7e4b31Steve McKay 6207be125b91f110b30f5f958e217368fc5f7e4b31Steve McKay @Override 6307be125b91f110b30f5f958e217368fc5f7e4b31Steve McKay public void onRequestDisallowInterceptTouchEvent(boolean disallowIntercept) { 6407be125b91f110b30f5f958e217368fc5f7e4b31Steve McKay } 6507be125b91f110b30f5f958e217368fc5f7e4b31Steve McKay }); 6607be125b91f110b30f5f958e217368fc5f7e4b31Steve McKay } 6707be125b91f110b30f5f958e217368fc5f7e4b31Steve McKay 6807be125b91f110b30f5f958e217368fc5f7e4b31Steve McKay /** 695bf51ec2ce8ba84ab56ab866ac8539c42d87a2f0Steve McKay * @param toolType See MotionEvent for details on available types. 705bf51ec2ce8ba84ab56ab866ac8539c42d87a2f0Steve McKay * @param delegate An {@link OnItemTouchListener} to receive events 715bf51ec2ce8ba84ab56ab866ac8539c42d87a2f0Steve McKay * of {@code toolType}. 7207be125b91f110b30f5f958e217368fc5f7e4b31Steve McKay */ 735bf51ec2ce8ba84ab56ab866ac8539c42d87a2f0Steve McKay public void register(int toolType, OnItemTouchListener delegate) { 745bf51ec2ce8ba84ab56ab866ac8539c42d87a2f0Steve McKay checkArgument(delegate != null); 7507be125b91f110b30f5f958e217368fc5f7e4b31Steve McKay mDelegates.set(toolType, delegate); 7607be125b91f110b30f5f958e217368fc5f7e4b31Steve McKay } 7707be125b91f110b30f5f958e217368fc5f7e4b31Steve McKay 7807be125b91f110b30f5f958e217368fc5f7e4b31Steve McKay @Override 7907be125b91f110b30f5f958e217368fc5f7e4b31Steve McKay public boolean onInterceptTouchEvent(RecyclerView rv, MotionEvent e) { 8007be125b91f110b30f5f958e217368fc5f7e4b31Steve McKay boolean handled = mDelegates.get(e).onInterceptTouchEvent(rv, e); 8107be125b91f110b30f5f958e217368fc5f7e4b31Steve McKay 8207be125b91f110b30f5f958e217368fc5f7e4b31Steve McKay // Forward all events to UserInputHandler. 8307be125b91f110b30f5f958e217368fc5f7e4b31Steve McKay // This is necessary since UserInputHandler needs to always see the first DOWN event. Or 8407be125b91f110b30f5f958e217368fc5f7e4b31Steve McKay // else all future UP events will be tossed. 8507be125b91f110b30f5f958e217368fc5f7e4b31Steve McKay handled |= mDetector.onTouchEvent(e); 8607be125b91f110b30f5f958e217368fc5f7e4b31Steve McKay 8707be125b91f110b30f5f958e217368fc5f7e4b31Steve McKay return handled; 8807be125b91f110b30f5f958e217368fc5f7e4b31Steve McKay } 8907be125b91f110b30f5f958e217368fc5f7e4b31Steve McKay 9007be125b91f110b30f5f958e217368fc5f7e4b31Steve McKay @Override 9107be125b91f110b30f5f958e217368fc5f7e4b31Steve McKay public void onTouchEvent(RecyclerView rv, MotionEvent e) { 9207be125b91f110b30f5f958e217368fc5f7e4b31Steve McKay mDelegates.get(e).onTouchEvent(rv, e); 9307be125b91f110b30f5f958e217368fc5f7e4b31Steve McKay 9407be125b91f110b30f5f958e217368fc5f7e4b31Steve McKay // Note: even though this event is being handled as part of gestures such as drag and band, 9507be125b91f110b30f5f958e217368fc5f7e4b31Steve McKay // continue forwarding to the GestureDetector. The detector needs to see the entire cluster 9607be125b91f110b30f5f958e217368fc5f7e4b31Steve McKay // of events in order to properly interpret other gestures, such as long press. 9707be125b91f110b30f5f958e217368fc5f7e4b31Steve McKay mDetector.onTouchEvent(e); 9807be125b91f110b30f5f958e217368fc5f7e4b31Steve McKay } 9907be125b91f110b30f5f958e217368fc5f7e4b31Steve McKay 10007be125b91f110b30f5f958e217368fc5f7e4b31Steve McKay @Override 10107be125b91f110b30f5f958e217368fc5f7e4b31Steve McKay public void onRequestDisallowInterceptTouchEvent(boolean disallowIntercept) {} 10207be125b91f110b30f5f958e217368fc5f7e4b31Steve McKay} 103