interface XDropTargetListener in module com::sun::star::datatransfer::dnd::

(Global Index)

Syntax

interface XDropTargetListener : com::sun::star::lang::XEventListener ;

Description

This interface is the callback interface used by the drop target object to provide notification of Drag and Drop operations that involve the subject drop target.

Methods of this interface may be implemented to provide "drag under" visual feedback to the user throughout the Drag and Drop operation.

Method Summary

drop The drag operation has terminated with a drop on this drop target.

dragEnter Called when a drag operation has encountered the drop target.

dragExit The drag operation has departed the drop target without dropping.

dragOver Called when a drag operation is ongoing on the drop target.

dropActionChanged Called when the user has modified the drop gesture.

Method Details



drop

Syntax

void drop (
com::sun::star::datatransfer::dnd::DropTargetDropEvent dtde );

Description

The drag operation has terminated with a drop on this drop target.

NOTE: This method should not be oneway. The implentation has to wait until the method XDropTargetDropContext::dropComplete() is called before releasing the data for the drop operation. This should occur before returning from drop in a normal flow of operation. Also, the implementor of XDropTargetListener should not assume the DropTargetDropEvent to be meaningful after returning from the XDropTargetListener::drop() method.

Parameter dtde

The DropTargetDropEvent .

dragEnter

Syntax

oneway void dragEnter (
com::sun::star::datatransfer::dnd::DropTargetDragEnterEvent dtdee );

Description

Called when a drag operation has encountered the drop target.

Parameter dtde

The DropTargetDragEvent .

dragExit

Syntax

oneway void dragExit (
com::sun::star::datatransfer::dnd::DropTargetEvent dte );

Description

The drag operation has departed the drop target without dropping.

Parameter dte

The DropTargetEvent .

dragOver

Syntax

oneway void dragOver (
com::sun::star::datatransfer::dnd::DropTargetDragEvent dtde );

Description

Called when a drag operation is ongoing on the drop target.

Parameter dtde

The DropTargetEvent .

dropActionChanged

Syntax

oneway void dropActionChanged (
com::sun::star::datatransfer::dnd::DropTargetDragEvent dtde );

Description

Called when the user has modified the drop gesture.

Parameter dtde

The DropTargetEvent .
Top of Page