KDNDDropZone Class Reference

[Kangaroo Index] [Kangaroo Hierarchy] [Headers]


Drop zone for KDE Drag n Drop. More...

#include <kdeobjc/Drag.h>

Inherits: QObject (QtObjc)

Public Members


Detailed Description

Drop zone for KDE Drag n Drop.

You can create a DropZone for every widget. When the user makes a drop over this widget, the KDNDDropZone takes over control.

The KDE drag and drop classes are based on the Offix Drag and Drop protocol, but are not compatible with it yet.

Currently used types are: DndText, DndURL.

Derived from the C++ header 'drag.h' by Torben Weis (weis@kde.org)


-initFromParent:type:

Create a DropZone for the widget _parent.

Parameters:
_type The type of Drop events to accept, eg DndURL.
_parent The parent of this dropzone, usually the widget for which you wish to receive drop events.

-drop:size:type:x:y:

This function is called when a drop event occurs.

Parameters:
_type The type of the data, eg DndURL means a URL was dropped.
_data A reference to the dropped data.
_size The length of the data dropped.
_x,_y The global coordinates of the drop.

-enter:size:type:x:y:

This function is called when an icon is being dragged over this drop zone.

Note that the icon may never have left the drop zone; the user may be dragging it around withing this zone and this function would still be called.

Parameters:
_type The type of the data, eg DndURL means a URL is being dragged.
_data A reference to the dragged data.
_size The length of the data dragged.
_x,_y The global coordinates of the drag.

-leave

This function is called when the icon being dragged has left this drop zone.

-getURLList

Decode the dropped data into a list of URLs. This should only be called if the dropped data was of type DndURL.

Note that the contents of this list are only valid till the next drop event.

-getData

Get dropped data.

Returns:
A reference to the dropped data.

-getDataSize

Get dropped data length.

Returns:
the length of the data that was dropped.

-getDataType

Get drop data type.

Returns:
the type of the data dropped.

-getMouseX

Get the mouse position at which the item was dropped.

Returns:
the X coordinate at which the item was dropped.
See Also:
-getMouseY

-getMouseY

Get the mouse position at which the item was dropped.

Returns:
the Y coordinate at which the item was dropped.
See Also:
-getMouseX

-getAcceptType

The types of dropped data this drop zone will accept.

Returns:
the types of drops accepted.

-accepts:

Tests whether this data type will be accepted.

Parameters:
_type the data type to be tested.
Returns:
YES if this type will be accepted, NO otherwise.

-getWidget

Get the parent widget.

Returns:
the parent widget for which this object is monitoring drops.

-dropAction:

Emitted when a drop has occurred.

The zone into which the drop has occurred is passed as a parameter.

-dropEnter:

Emitted when an icon is dragged into and inside this drop zone.

-dropLeave:

Emitted when an icon is dragged out of this drop zone.

-parseURLList

Fills 'urlList' with the URLs in 'dndData'. Works only if 'dndType' is DndURL.


Documentation generated by duke@tipitina on Sat May 6 11:42:52 EDT 2000
Kdoc