/* * Copyright 2017 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 androidx.recyclerview.selection; import static androidx.core.util.Preconditions.checkArgument; import static androidx.core.util.Preconditions.checkState; import android.view.GestureDetector.SimpleOnGestureListener; import android.view.MotionEvent; import androidx.annotation.NonNull; import androidx.annotation.Nullable; import androidx.recyclerview.selection.ItemDetailsLookup.ItemDetails; import androidx.recyclerview.widget.RecyclerView; /** * Base class for handlers that can be registered w/ {@link GestureRouter}. */ abstract class MotionInputHandler extends SimpleOnGestureListener { protected final SelectionTracker mSelectionTracker; private final ItemKeyProvider mKeyProvider; private final FocusDelegate mFocusDelegate; MotionInputHandler( @NonNull SelectionTracker selectionTracker, @NonNull ItemKeyProvider keyProvider, @NonNull FocusDelegate focusDelegate) { checkArgument(selectionTracker != null); checkArgument(keyProvider != null); checkArgument(focusDelegate != null); mSelectionTracker = selectionTracker; mKeyProvider = keyProvider; mFocusDelegate = focusDelegate; } final boolean selectItem(@NonNull ItemDetails details) { checkArgument(details != null); checkArgument(hasPosition(details)); checkArgument(hasSelectionKey(details)); if (mSelectionTracker.select(details.getSelectionKey())) { mSelectionTracker.anchorRange(details.getPosition()); } // we set the focus on this doc so it will be the origin for keyboard events or shift+clicks // if there is only a single item selected, otherwise clear focus if (mSelectionTracker.getSelection().size() == 1) { mFocusDelegate.focusItem(details); } else { mFocusDelegate.clearFocus(); } return true; } protected final boolean focusItem(@NonNull ItemDetails details) { checkArgument(details != null); checkArgument(hasSelectionKey(details)); mSelectionTracker.clearSelection(); mFocusDelegate.focusItem(details); return true; } protected final void extendSelectionRange(@NonNull ItemDetails details) { checkState(mKeyProvider.hasAccess(ItemKeyProvider.SCOPE_MAPPED)); checkArgument(hasPosition(details)); checkArgument(hasSelectionKey(details)); mSelectionTracker.extendRange(details.getPosition()); mFocusDelegate.focusItem(details); } final boolean isRangeExtension(@NonNull MotionEvent e) { return MotionEvents.isShiftKeyPressed(e) && mSelectionTracker.isRangeActive() // Without full corpus access we can't reliably implement range // as a user can scroll *anywhere* then SHIFT+click. && mKeyProvider.hasAccess(ItemKeyProvider.SCOPE_MAPPED); } boolean shouldClearSelection(@NonNull MotionEvent e, @NonNull ItemDetails item) { return !MotionEvents.isCtrlKeyPressed(e) && !item.inSelectionHotspot(e) && !mSelectionTracker.isSelected(item.getSelectionKey()); } static boolean hasSelectionKey(@Nullable ItemDetails item) { return item != null && item.getSelectionKey() != null; } static boolean hasPosition(@Nullable ItemDetails item) { return item != null && item.getPosition() != RecyclerView.NO_POSITION; } }