KMultipleDrag Class Reference

#include <tdemultipledrag.h>

Inherits TQDragObject.

Public Member Functions
	KMultipleDrag (TQWidget *dragSource=0, const char *name=0)
void	addDragObject (TQDragObject *dragObject)
virtual TQByteArray	encodedData (const char *mime) const
virtual const char *	format (int i) const

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

Protected Attributes
TQPtrList< TQDragObject >	m_dragObjects
TQValueList< int >	m_numberFormats

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 TQImageDrag object and a KURLDrag object), and bundle them together using KMultipleDrag.

Sample code for this:

KMultipleDrag *drag = new KMultipleDrag( parentWidget );
drag->addDragObject( new TQImageDrag( someQImage, 0 ) );
drag->addDragObject( new KURLDrag( 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.

Author

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

Definition at line 54 of file tdemultipledrag.h.

Constructor & Destructor Documentation

KMultipleDrag()

KMultipleDrag::KMultipleDrag	(	TQWidget *	dragSource = 0,
		const char *	name = 0
	)

Create a new KMultipleDrag 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 tdemultipledrag.cpp.

Member Function Documentation

addDragObject()

void KMultipleDrag::addDragObject

(

TQDragObject *

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 tdemultipledrag.cpp.

encodedData()

TQByteArray KMultipleDrag::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 tdemultipledrag.cpp.

format()

const char * KMultipleDrag::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 tdemultipledrag.cpp.

virtual_hook()

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

protectedvirtual

Definition at line 77 of file tdemultipledrag.cpp.

Member Data Documentation

m_dragObjects

TQPtrList<TQDragObject> KMultipleDrag::m_dragObjects

protected

Definition at line 95 of file tdemultipledrag.h.

m_numberFormats

TQValueList<int> KMultipleDrag::m_numberFormats

protected

Definition at line 96 of file tdemultipledrag.h.

---

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

• tdemultipledrag.h
• tdemultipledrag.cpp