org.virtualbox_7_0
Class IDnDTarget

java.lang.Object
  extended by org.virtualbox_7_0.IUnknown
      extended by org.virtualbox_7_0.IDnDBase
          extended by org.virtualbox_7_0.IDnDTarget
Direct Known Subclasses:
IGuestDnDTarget

public class IDnDTarget
extends IDnDBase

Abstract interface for handling drag'n drop targets. Interface ID: {FF5BEFC3-4BA3-7903-2AA4-43988BA11554}


Field Summary
 
Fields inherited from class org.virtualbox_7_0.IUnknown
obj, objMgr, port
 
Constructor Summary
IDnDTarget(java.lang.String wrapped, org.virtualbox_7_0.ObjectRefManager objMgr, org.virtualbox_7_0.jaxws.VboxPortType port)
           
 
Method Summary
 java.lang.Boolean cancel()
          Requests cancelling the current operation.
 DnDAction drop(java.lang.Long screenId, java.lang.Long x, java.lang.Long y, DnDAction defaultAction, java.util.List<DnDAction> allowedActions, java.util.List<java.lang.String> formats, Holder<java.lang.String> format)
          Informs the target about a drop event.
 DnDAction enter(java.lang.Long screenId, java.lang.Long y, java.lang.Long x, DnDAction defaultAction, java.util.List<DnDAction> allowedActions, java.util.List<java.lang.String> formats)
          Informs the target about a drag and drop enter event.
 void leave(java.lang.Long screenId)
          Informs the target about a drag and drop leave event.
 DnDAction move(java.lang.Long screenId, java.lang.Long x, java.lang.Long y, DnDAction defaultAction, java.util.List<DnDAction> allowedActions, java.util.List<java.lang.String> formats)
          Informs the target about a drag and drop move event.
static IDnDTarget queryInterface(IUnknown obj)
           
 IProgress sendData(java.lang.Long screenId, java.lang.String format, byte[] data)
          Initiates sending data to the target.
 
Methods inherited from class org.virtualbox_7_0.IDnDBase
addFormats, getFormats, isFormatSupported, removeFormats
 
Methods inherited from class org.virtualbox_7_0.IUnknown
getObjMgr, getRemoteWSPort, getWrapped, releaseRemote
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

IDnDTarget

public IDnDTarget(java.lang.String wrapped,
                  org.virtualbox_7_0.ObjectRefManager objMgr,
                  org.virtualbox_7_0.jaxws.VboxPortType port)
Method Detail

queryInterface

public static IDnDTarget queryInterface(IUnknown obj)

enter

public DnDAction enter(java.lang.Long screenId,
                       java.lang.Long y,
                       java.lang.Long x,
                       DnDAction defaultAction,
                       java.util.List<DnDAction> allowedActions,
                       java.util.List<java.lang.String> formats)
Informs the target about a drag and drop enter event.

Expected result codes:
VBOX_E_VM_ERROR - VMM device is not available.

Parameters:
screenId - The screen ID where the drag and drop event occurred.
y - Y-position of the event.
x - X-position of the event.
defaultAction - The default action to use.
allowedActions - The actions which are allowed.
formats - The supported MIME types.
Returns:
The resulting action of this event.

move

public DnDAction move(java.lang.Long screenId,
                      java.lang.Long x,
                      java.lang.Long y,
                      DnDAction defaultAction,
                      java.util.List<DnDAction> allowedActions,
                      java.util.List<java.lang.String> formats)
Informs the target about a drag and drop move event.

Expected result codes:
VBOX_E_VM_ERROR - VMM device is not available.

Parameters:
screenId - The screen ID where the drag and drop event occurred.
x - X-position of the event.
y - Y-position of the event.
defaultAction - The default action to use.
allowedActions - The actions which are allowed.
formats - The supported MIME types.
Returns:
The resulting action of this event.

leave

public void leave(java.lang.Long screenId)
Informs the target about a drag and drop leave event.

Expected result codes:
VBOX_E_VM_ERROR - VMM device is not available.

Parameters:
screenId - The screen ID where the drag and drop event occurred.

drop

public DnDAction drop(java.lang.Long screenId,
                      java.lang.Long x,
                      java.lang.Long y,
                      DnDAction defaultAction,
                      java.util.List<DnDAction> allowedActions,
                      java.util.List<java.lang.String> formats,
                      Holder<java.lang.String> format)
Informs the target about a drop event.

Expected result codes:
VBOX_E_VM_ERROR - VMM device is not available.

Parameters:
screenId - The screen ID where the Drag and Drop event occurred.
x - X-position of the event.
y - Y-position of the event.
defaultAction - The default action to use.
allowedActions - The actions which are allowed.
formats - The supported MIME types.
format - The resulting format of this event.
Returns:
The resulting action of this event.

sendData

public IProgress sendData(java.lang.Long screenId,
                          java.lang.String format,
                          byte[] data)
Initiates sending data to the target.

Expected result codes:
VBOX_E_VM_ERROR - VMM device is not available.

Parameters:
screenId - The screen ID where the drag and drop event occurred.
format - The MIME type the data is in.
data - The actual data.
Returns:
Progress object to track the operation completion.

cancel

public java.lang.Boolean cancel()
Requests cancelling the current operation. The target can veto the request in case the operation is not cancelable at the moment.

Expected result codes:
VBOX_E_VM_ERROR - VMM device is not available.

Returns:
Whether the target has vetoed cancelling the operation.