class KDNDWidget

Public Members

• KDNDWidget ( QWidget *_parent=0, const char *_name=0, WFlags f=0 )
• virtual ~KDNDWidget ()
• virtual void startDrag ( KDNDIcon *_icon, char *_data, int _size, int _type, int _dx, int _dy )

Protected Members

• 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 * )
• bool drag
• char * dndData
• int dndSize
• int dndType
• int dndOffsetX
• int dndOffsetY
• KDNDIcon * dndIcon
• Window dndLastWindow

Constructor.

Destructor.

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.

Finds the root window belonging to the global point p.

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

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

See also: dndMouseMoveEvent

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

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

See also: dndMouseReleaseEvent

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.

Perform internal housekeeping after a root drop event.

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

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.

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.

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.

Are we just doing DND ?

The data that is currently dragged.

data size

data type

The offset we got from 'startDrag'

The offset we got from 'startDrag'

The icon we are moving around

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: bhcompile@stripples.devel.redhat.com on Thu Jul 26 13:37:38 200.