Top   Module   Use   Manual   Index 
 EXPORTING SERVICES | METHODS' SUMMARY | METHODS' DETAILS 

com :: sun :: star :: datatransfer :: dnd ::

interface XDropTarget

Base Interface
com::sun::star::uno::XInterface

Description
This interface is implemented by a view or window that supports drop operations.

Differently to Java, the association between view and interface is fixed and cannot be changed. Otherwise, the AWT messaging would have to be implemented for any window supporting Drag and Drop operations, which would be a performance issue.



Known Services which Export this Interface

com::sun::star::datatransfer::dnd::OleDropTarget This service connects the Java-like UNO Drag & Drop protocol to the protocol used on window platforms. It realizes the drop target.
com::sun::star::datatransfer::dnd::X11DropTarget This service connects the Java-like UNO Drag and Drop protocol to the X Drag and Drop protocol used on X-Servers to transfer data between application via Drag and Drop operations.

Methods' Summary

addDropTargetListener Add a DropTargetListener.
removeDropTargetListener Remove a drop target listener.
isActive Indicates either a drop target object is active or not.
setActive Sets the drop target object active or inactive.
getDefaultActions Determine the actions supported by a drop target.
setDefaultActions Sets the default acceptable actions for this drop target.

Methods' Details

addDropTargetListener
 
[ oneway ] void
addDropTargetListener(
[ in ] com::sun::star::datatransfer::dnd::XDropTargetListener dtl );

Description
Add a DropTargetListener.

The listener will be queried for the XAutoscroll interface to see if it supports autoscrolling.

Parameter dtl
The listener to add to the notification list.
removeDropTargetListener
 
[ oneway ] void
removeDropTargetListener(
[ in ] com::sun::star::datatransfer::dnd::XDropTargetListener dtl );

Description
Remove a drop target listener.
Parameter dtl
The listener to remove from notification list.
isActive
 
boolean
isActive();
Description
Indicates either a drop target object is active or not.
Returns
A boolean indicating whether or not this drop target object is currently active, that is ready to accept drops.
setActive
 
void
setActive(
[ in ] boolean active );

Description
Sets the drop target object active or inactive.
Parameter active
A value of true sets the drop target object active.

A value of false sets the drop target object inactive.

getDefaultActions
 
byte
getDefaultActions();
Description
Determine the actions supported by a drop target.
Returns
The current action or actions supported by this drop target.

By default this will include all drag and drop actions.

See also
com::sun::star::datatransfer::dnd::DNDConstants
setDefaultActions
 
[ oneway ] void
setDefaultActions(
[ in ] byte actions );

Description
Sets the default acceptable actions for this drop target.

This method is a way to reduce the number of Drag and Drop events by blocking events for actions not supported by this target.

By default the listener will receive notifications for all actions.

Parameter actions
The actions.
See also
com::sun::star::datatransfer::dnd::DNDConstants

Top of Page