KDNDWidget Class Reference

[Kangaroo Index] [Kangaroo Hierarchy] [Headers]


A widget for drag support. More...

#include <kdeobjc/Drag.h>

Inherits: QWidget (QtObjc)

Public Members


Detailed Description

A widget for drag support.

If you require only drop support you dont need this widget, you just need KDndDropZone.

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


-startDrag:data:size:type:dx:dy:

Start a drag.

Call this function when you notice that the user wants to drag something around, usually from a dndMouseMoveEvent.

Parameters:
_icon The icon that the user can drag around.
_type The type of the data that is being dragged, eg DndURL.
_data A reference to the data being dragged. A deep copy is made of this data, so you don't need to maintain its value after you call this function.
_size The length of the data pointed to by _data.
_dx,_dy The difference between the icons upper left corner and the mouse reference. For example when the user clicks the mouse over the middle of a pixmap, _dx and _dy would be ' - pixmap.width() / 2 ' and ' - pixmap.height() / 2 '. This is just provided for look and feel.

-findRootWindow:

Finds the root window belonging to the global point p.

-mouseMoveEvent:

This function MUST be called by your implementation if you overload it.

In nearly all cases, you probably mean to call dndMouseMoveEvent().

See Also:
KDNDWidget::-dndMouseMoveEvent

-mouseReleaseEvent:

This function MUST be called by your implementation if you overload it.

In nearly all cases, you probably mean to call dndMouseReleaseEvent().

See Also:
KDNDWidget::-dndMouseReleaseEvent

-rootDropEvent::

A root drop occurred.

At the point (_x,_y) the user dropped the icon. If there is now window below this point, this function is called. Usually it emits a XEvent, so that every application gets informed about this. This function is only called if the drag started in this widget.

See KApplication for details on receiving root drop events.

-rootDropEvent

Perform internal housekeeping after a root drop event.

If you must overload rootDropEvent(...), call this function at the end to do some clean up.

-dndMouseReleaseEvent:

Your mouse release event function.

Usually you will only set 'pressed' ( see dndMouseMoveEvent) to FALSE here. The function is only called if the release event had nothing to do with DND.


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