diff options
author | Joe Onorato <joeo@android.com> | 2009-07-30 10:15:07 -0700 |
---|---|---|
committer | Joe Onorato <joeo@android.com> | 2009-07-30 10:15:07 -0700 |
commit | fca7c88f9dba895d9f6cf52c6f0e656445063e3e (patch) | |
tree | 149d776e169783fb7a44325c981e11afaa7c0ffe /src/com/android/launcher2/DropTarget.java | |
parent | 1b12645748c88076e2a124d5bc5550c65bf11cd0 (diff) | |
download | android_packages_apps_Trebuchet-fca7c88f9dba895d9f6cf52c6f0e656445063e3e.tar.gz android_packages_apps_Trebuchet-fca7c88f9dba895d9f6cf52c6f0e656445063e3e.tar.bz2 android_packages_apps_Trebuchet-fca7c88f9dba895d9f6cf52c6f0e656445063e3e.zip |
Move com/android/launcher -> com/android/launcher2
Diffstat (limited to 'src/com/android/launcher2/DropTarget.java')
-rw-r--r-- | src/com/android/launcher2/DropTarget.java | 81 |
1 files changed, 81 insertions, 0 deletions
diff --git a/src/com/android/launcher2/DropTarget.java b/src/com/android/launcher2/DropTarget.java new file mode 100644 index 000000000..4835323d8 --- /dev/null +++ b/src/com/android/launcher2/DropTarget.java @@ -0,0 +1,81 @@ +/* + * Copyright (C) 2008 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.launcher; + +import android.graphics.Rect; + +/** + * Interface defining an object that can receive a drag. + * + */ +public interface DropTarget { + + /** + * Handle an object being dropped on the DropTarget + * + * @param source DragSource where the drag started + * @param x X coordinate of the drop location + * @param y Y coordinate of the drop location + * @param xOffset Horizontal offset with the object being dragged where the original touch happened + * @param yOffset Vertical offset with the object being dragged where the original touch happened + * @param dragInfo Data associated with the object being dragged + * + */ + void onDrop(DragSource source, int x, int y, int xOffset, int yOffset, Object dragInfo); + + void onDragEnter(DragSource source, int x, int y, int xOffset, int yOffset, Object dragInfo); + + void onDragOver(DragSource source, int x, int y, int xOffset, int yOffset, Object dragInfo); + + void onDragExit(DragSource source, int x, int y, int xOffset, int yOffset, Object dragInfo); + + /** + * Check if a drop action can occur at, or near, the requested location. + * This may be called repeatedly during a drag, so any calls should return + * quickly. + * + * @param source DragSource where the drag started + * @param x X coordinate of the drop location + * @param y Y coordinate of the drop location + * @param xOffset Horizontal offset with the object being dragged where the + * original touch happened + * @param yOffset Vertical offset with the object being dragged where the + * original touch happened + * @param dragInfo Data associated with the object being dragged + * @return True if the drop will be accepted, false otherwise. + */ + boolean acceptDrop(DragSource source, int x, int y, int xOffset, int yOffset, Object dragInfo); + + /** + * Estimate the surface area where this object would land if dropped at the + * given location. + * + * @param source DragSource where the drag started + * @param x X coordinate of the drop location + * @param y Y coordinate of the drop location + * @param xOffset Horizontal offset with the object being dragged where the + * original touch happened + * @param yOffset Vertical offset with the object being dragged where the + * original touch happened + * @param dragInfo Data associated with the object being dragged + * @param recycle {@link Rect} object to be possibly recycled. + * @return Estimated area that would be occupied if object was dropped at + * the given location. Should return null if no estimate is found, + * or if this target doesn't provide estimations. + */ + Rect estimateDropLocation(DragSource source, int x, int y, int xOffset, int yOffset, Object dragInfo, Rect recycle); +} |