1 /*
2  * Copyright (c) 1997, 2014, Oracle and/or its affiliates. All rights reserved.
3  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
4  *
5  * This code is free software; you can redistribute it and/or modify it
6  * under the terms of the GNU General Public License version 2 only, as
7  * published by the Free Software Foundation.  Oracle designates this
8  * particular file as subject to the "Classpath" exception as provided
9  * by Oracle in the LICENSE file that accompanied this code.
10  *
11  * This code is distributed in the hope that it will be useful, but WITHOUT
12  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
13  * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
14  * version 2 for more details (a copy is included in the LICENSE file that
15  * accompanied this code).
16  *
17  * You should have received a copy of the GNU General Public License version
18  * 2 along with this work; if not, write to the Free Software Foundation,
19  * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
20  *
21  * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
22  * or visit www.oracle.com if you need additional information or have any
23  * questions.
24  */
25 
26 package java.awt.dnd.peer;
27 
28 import java.awt.Cursor;
29 import java.awt.Image;
30 import java.awt.Point;
31 import java.awt.dnd.DragSourceContext;
32 import java.awt.dnd.InvalidDnDOperationException;
33 
34 
35 /**
36  * <p>
37  * This interface is supplied by the underlying window system platform to
38  * expose the behaviors of the Drag and Drop system to an originator of
39  * the same
40  * </p>
41  *
42  * @since 1.2
43  *
44  */
45 
46 public interface DragSourceContextPeer {
47 
48     /**
49      * start a drag
50      * @param dsc the DragSourceContext
51      * @param c the cursor
52      * @param dragImage the image to be dragged
53      * @param imageOffset the offset
54      */
55 
startDrag(DragSourceContext dsc, Cursor c, Image dragImage, Point imageOffset)56     void startDrag(DragSourceContext dsc, Cursor c, Image dragImage, Point imageOffset) throws InvalidDnDOperationException;
57 
58     /**
59      * return the current drag cursor
60      * @return the current drag cursor
61      */
62 
getCursor()63     Cursor getCursor();
64 
65     /**
66      * set the current drag cursor
67      * @param c the cursor
68      */
69 
setCursor(Cursor c)70     void setCursor(Cursor c) throws InvalidDnDOperationException;
71 
72     /**
73      * notify the peer that the Transferables DataFlavors have changed
74      */
75 
transferablesFlavorsChanged()76     void transferablesFlavorsChanged();
77 }
78