class KDNDWidget

Public Methods

•  KDNDWidget ( QWidget *_parent=0, const char *_name=0, WFlags f=0 ) : QWidget( _parent, _name, f ) , drag(false), dndData(0L), dndSize(0), dndType(0), dndOffsetX(0), dndOffsetY(0), dndIcon(0L), dndLastWindow(0)
• virtual ~ KDNDWidget ()
• virtual void  startDrag ( KDNDIcon *_icon, char *_data, int _size, int _type, int _dx, int _dy )

Protected Methods

• virtual Window  findRootWindow ( QPoint & p )
• virtual void  mouseMoveEvent ( QMouseEvent * )
• virtual void  mouseReleaseEvent ( QMouseEvent * )
• virtual void  rootDropEvent ( int _x, int _y )
• virtual void  rootDropEvent ()
• virtual void  dragEndEvent ()
• virtual void  dndMouseMoveEvent ( QMouseEvent * )
• virtual void  dndMouseReleaseEvent ( QMouseEvent * )

Protected Members

• bool drag
• char *dndData
• int dndSize
• int dndType
• int dndOffsetX
• int dndOffsetY
• KDNDIcon *dndIcon
• Window dndLastWindow

Constructor.

[virtual]

Destructor.

[virtual]

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.
_data	A pointer 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.
_type	The type of the data that is being dragged, eg DndURL.
_dx	,_dy The difference between the icons upper left corner and the mouse pointer. 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.

[protected virtual]

Finds the root window belonging to the global point p.

[protected virtual]

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

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

[protected virtual]

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

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

[protected virtual]

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.

[protected virtual]

Perform internal housekeeping after a root drop event.

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

[protected virtual]

Called when a drag is ended.

This function is only called if the drag started in this widget. Overload it to do your own clean up.

[protected virtual]

Overload this instead of mouseMoveEvent. Ususally drags are started in this functions. A implementation might look like this:

 void KFileView::dndMouseMoveEvent( QMouseEvent * _mouse )
    {
    // 'pressed' is set in mousePressedEvent(...)
    if ( !pressed )
	return;

    int x = _mouse->pos().x();
    int y = _mouse->pos().y();

    if ( abs( x - press_x ) > Dnd_X_Precision || abs( y - press_y ) > Dnd_Y_Precision )
    {
        QString data = "Transfer me";
	QPoint p = mapToGlobal( _mouse->pos() );
	QPixmap pixmap = typ->getPixmap( filename );
	int dx = - pixmap.width() / 2;
	int dy = - pixmap.height() / 2;

	startDrag( new KDNDIcon( pixmap, p.x() + dx, p.y() + dy ), data.data(), data.length(), DndText, dx, dy );
    }
    else
    {
      Do something different
    }

The function is only called if the mouse movement was not part of a drag process.

[protected virtual]

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.

[protected]

Are we just doing DND ?

[protected]

The data that is currently dragged.

[protected]

data size

[protected]

data type

[protected]

The offset we got from 'startDrag'

[protected]

The offset we got from 'startDrag'

[protected]

The icon we are moving around

[protected]

The last window we entered with the mouse pointer.

• Version: $Id: drag.h,v 1.24 1998/10/22 12:22:37 ettrich Exp $
• Author: Torben Weis (weis@kde.org)
• Generated: root@george.devel.redhat.com on Thu Sep 14 21:18:35 2000, using kdoc 2.0a36.