K3MultipleDrag Class Reference

#include <k3multipledrag.h>

Inheritance diagram for K3MultipleDrag:

Public Member Functions
	K3MultipleDrag (QWidget *dragSource=0, const char *name=0)
void	addDragObject (Q3DragObject *dragObject)
virtual QByteArray	encodedData (const char *mime) const
virtual const char *	format (int i) const

Protected Member Functions
virtual void	virtual_hook (int id, void *data)

Detailed Description

This class makes it easy for applications to provide a drag object (for drag-n-drop or for clipboard) that has several representations of the same data, under different formats.

Instead of creating a specific class for each case (as would otherwise be necessary), you can simply create independent drag objects (e.g. a Q3ImageDrag object and a K3URLDrag object), and bundle them together using K3MultipleDrag.

Sample code for this:

K3MultipleDrag *drag = new K3MultipleDrag( parentWidget );
drag->addDragObject( new Q3ImageDrag( someQImage, 0 ) );
drag->addDragObject( new K3URLDrag( someKUrl, 0 ) );
drag->drag();

Note that the drag objects added to the multiple drag become owned by it. For that reason their parent should be 0.

Deprecated:

use QMimeData instead

Author

David Faure faure.nosp@m.@kde.nosp@m..org

Definition at line 55 of file k3multipledrag.h.

Constructor & Destructor Documentation

K3MultipleDrag::K3MultipleDrag	(	QWidget *	dragSource = 0,
		const char *	name = 0
	)

Create a new K3MultipleDrag object.

Parameters

dragSource	the parent object which is the source of the data, 0 for a parent-less object
name	the name of the object, can be 0

Definition at line 25 of file k3multipledrag.cpp.

Member Function Documentation

void K3MultipleDrag::addDragObject

(

Q3DragObject *

dragObject

)

Call this to add each underlying drag object to the multiple drag object.

The drag object should not have a parent because the multiple drag object will own it.

Parameters

dragObject

the drag object to add. Should have no parent object.

Definition at line 31 of file k3multipledrag.cpp.

QByteArray K3MultipleDrag::encodedData ( const char *  mime ) const

virtual

Returns the data of a drag object with that supports the given mime type.

Parameters

mime	the mime type to search

Returns

the data, or a null byte array if not found

Reimplemented from superclass.

Definition at line 42 of file k3multipledrag.cpp.

const char * K3MultipleDrag::format ( int  i ) const

virtual

Returns the i'th supported format, or 0.

Parameters

i	the number of the format to check

Returns

the format with the number i, or 0 otherwise

Reimplemented from superclass.

Definition at line 58 of file k3multipledrag.cpp.

void K3MultipleDrag::virtual_hook ( int  id, void *  data  )

protectedvirtual

Definition at line 77 of file k3multipledrag.cpp.

---

The documentation for this class was generated from the following files:

• k3multipledrag.h
• k3multipledrag.cpp