1 /* 2 * Copyright (C) 2008 The Android Open Source Project 3 * 4 * Licensed under the Apache License, Version 2.0 (the "License"); 5 * you may not use this file except in compliance with the License. 6 * You may obtain a copy of the License at 7 * 8 * http://www.apache.org/licenses/LICENSE-2.0 9 * 10 * Unless required by applicable law or agreed to in writing, software 11 * distributed under the License is distributed on an "AS IS" BASIS, 12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13 * See the License for the specific language governing permissions and 14 * limitations under the License. 15 */ 16 17 package com.android.launcher3; 18 19 import android.view.View; 20 21 import com.android.launcher3.DropTarget.DragObject; 22 import com.android.launcher3.logging.UserEventDispatcher.LaunchSourceProvider; 23 24 /** 25 * Interface defining an object that can originate a drag. 26 */ 27 public interface DragSource extends LaunchSourceProvider { 28 29 /** 30 * @return whether items dragged from this source supports 31 */ supportsFlingToDelete()32 boolean supportsFlingToDelete(); 33 34 /** 35 * @return whether items dragged from this source supports 'App Info' 36 */ supportsAppInfoDropTarget()37 boolean supportsAppInfoDropTarget(); 38 39 /** 40 * @return whether items dragged from this source supports 'Delete' drop target (e.g. to remove 41 * a shortcut.) If this returns false, the drop target will say "Cancel" instead of "Remove." 42 */ supportsDeleteDropTarget()43 boolean supportsDeleteDropTarget(); 44 45 /* 46 * @return the scale of the icons over the workspace icon size 47 */ getIntrinsicIconScaleFactor()48 float getIntrinsicIconScaleFactor(); 49 50 /** 51 * A callback specifically made back to the source after an item from this source has been flung 52 * to be deleted on a DropTarget. In such a situation, this method will be called after 53 * onDropCompleted, and more importantly, after the fling animation has completed. 54 */ onFlingToDeleteCompleted()55 void onFlingToDeleteCompleted(); 56 57 /** 58 * A callback made back to the source after an item from this source has been dropped on a 59 * DropTarget. 60 */ onDropCompleted(View target, DragObject d, boolean isFlingToDelete, boolean success)61 void onDropCompleted(View target, DragObject d, boolean isFlingToDelete, boolean success); 62 } 63