(incubating) | The Free and Open Productivity Suite
Announcing Apache OpenOffice 3.4

Developer's Guide

API

SDK

Tips 'n' Tricks

Miscellaneous

Content for OpenOffice.org version 3.3.

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

interface XDragSourceContext
Description
The drag source context class is responsible for managing the initiator side of the Drag and Drop protocol.

In particular, it is responsible for managing event notifications to the DragSourceListener and providing the Transferable state to enable the data transfer.

An instance of this class is created as a result of the method XDragSource::startDrag() being successfully invoked. This instance is responsible for tracking the state of the operation on behalf of the drag source and dispatching state changes to the drag source listener.

See also
XDragSourceContext, XDragSourceListener

Methods' Summary
getCurrentCursor Get the identifier of the currently used cursor.  
setCursor This method sets the current drag cursor.  
setImage This method sets the current drag image.  
transferablesFlavorsChanged This method notifies the context that the ::com::sun::star::datatransfer::DataFlavor types of the transferable object have changed.  
Methods' Details
getCurrentCursor
long
getCurrentCursor();

Description
Get the identifier of the currently used cursor.
Returns
The currently selected drag cursor.
setCursor
[oneway] void
setCursor( [in] long  cursorId );

Description
This method sets the current drag cursor.

This method should only be called to set another cursor than the default one for drag action currently selected by the user.

Invalid cursor identifiers will be ignored.

Parameter cursorId
The identifier the drag source returned when registering the cursor.
setImage
[oneway] void
setImage( [in] long  imageId );

Description
This method sets the current drag image.
Parameter dragImage
The identifier the drag source returned when registering the image (0 = none). Invalid identifier will be ignored.
transferablesFlavorsChanged
[oneway] void
transferablesFlavorsChanged();

Description
This method notifies the context that the ::com::sun::star::datatransfer::DataFlavor types of the transferable object have changed.
See also
::com::sun::star::datatransfer::XTransferable
Top of Page

Apache Feather

Copyright & License | Privacy | Contact Us

Apache and the Apache feather logos are trademarks of The Apache Software Foundation. OpenOffice.org and the seagull logo are registered trademarks of The Apache Software Foundation. Other names appearing on the site may be trademarks of their respective owners.

Apache OpenOffice is an effort undergoing incubation at The Apache Software Foundation (ASF), sponsored by the Apache Incubator. Incubation is required of all newly accepted projects until a further review indicates that the infrastructure, communications, and decision making process have stabilized in a manner consistent with other successful ASF projects. While incubation status is not necessarily a reflection of the completeness or stability of the code, it does indicate that the project has yet to be fully endorsed by the ASF.