1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16 """An interface for components supporting drop operations."""
17
18 from muntjac.ui.component import IComponent
19
20
22 """IDropTarget is an interface for components supporting drop operations. A
23 component that wants to receive drop events should implement this interface
24 and provide a L{DropHandler} which will handle the actual drop event.
25 """
26
28 """@return: the drop handler that will receive the dragged data or null
29 if drops are not currently accepted
30 """
31 raise NotImplementedError
32
33
35 """Called before the L{DragAndDropEvent} is passed to
36 L{DropHandler}. Implementation may for example translate the drop
37 target details provided by the client side (drop target) to meaningful
38 server side values. If null is returned the terminal implementation
39 will automatically create a L{TargetDetails} with raw client side data.
40
41 @see: DragSource#getTransferable(Map)
42
43 @param clientVariables:
44 data passed from the DropTargets client side counterpart.
45 @return: A DropTargetDetails object with the translated data or null to
46 use a default implementation.
47 """
48 raise NotImplementedError
49