---

KURLDrag Class Reference

#include <kurldrag.h>

List of all members.

Public Methods
	KURLDrag (const KURL::List &urls, QWidget *dragSource, const char *name)
	KURLDrag (const KURL::List &urls, const QMap< QString, QString > &metaData, QWidget *dragSource, const char *name)
QMap< QString, QString > &	metaData ()
Static Public Methods
KURLDrag *	newDrag (const KURL::List &urls, QWidget *dragSource=0, const char *name=0)
KURLDrag *	newDrag (const KURL::List &urls, const QMap< QString, QString > &metaData, QWidget *dragSource=0, const char *name=0)
bool	decode (const QMimeSource *e, KURL::List &urls)
bool	decode (const QMimeSource *e, KURL::List &urls, QMap< QString, QString > &metaData)
Protected Methods
	KURLDrag (const QStrList &urls, const QMap< QString, QString > &metaData, QWidget *dragSource, const char *name)

---

Detailed Description

This class is to be used instead of QUriDrag when using KURL. The reason is: QUriDrag (and the XDND/W3C standards) expect URLs to be encoded in UTF-8 (unicode), but KURL uses the current locale by default. The other reasons for using this class are:

• it exports text/plain (for dropping/pasting into lineedits, mails etc.)
• it has support for metadata, shipped as part of the dragobject This is important, for instance to set a correct HTTP referrer (some websites require it for downloading e.g. an image).

To create a drag object, use KURLDrag::newDrag() with a list of KURLs. To decode a drop, use KURLDrag::decode() or QUriDrag::decodeLocalFiles().

Definition at line 43 of file kurldrag.h.

---

Constructor & Destructor Documentation

KURLDrag::KURLDrag (  const KURL::List &    urls, QWidget *    dragSource, const char *    name )

Constructs an object to drag the list of URLs in urls. The dragSource and name arguments are passed on to QUriDrag, and the list of urls is converted to UTF-8 before being passed to QUriDrag. Parameters: urls  the list of URLs dragSource  the parent of the QObject name  the name of the QObject

KURLDrag::KURLDrag (  const KURL::List &    urls, const QMap< QString, QString > &    metaData, QWidget *    dragSource, const char *    name )

Constructs an object to drag the list of URLs in urls. This version also includes metadata. Parameters: urls  the list of URLs metaData  a map containing meta data dragSource  the parent of the QObject name  the name of the QObject See also: metaData()

KURLDrag::KURLDrag (  const QStrList &    urls, const QMap< QString, QString > &    metaData, QWidget *    dragSource, const char *    name )  [inline, protected]

Protected constructor - use newDrag Definition at line 122 of file kurldrag.h. References metaData().

---

Member Function Documentation

bool KURLDrag::decode (  const QMimeSource *    e, KURL::List &    urls, QMap< QString, QString > &    metaData )  [static]

Convenience method that decodes the contents of e into a list of KURLs and a set of metadata. You should be using this one, if possible. Parameters: e  the mime source urls  the list of urls will be written here metaData  the metadata map will be written here Returns: true if successful, false otherwise

bool KURLDrag::decode (  const QMimeSource *    e, KURL::List &    urls )  [static]

Convenience method that decodes the contents of e into a list of KURLs. Parameters: e  the mime source urls  the list of urls will be written here Returns: true if successful, false otherwise

QMap<QString, QString>& KURLDrag::metaData (    )  [inline]

Meta-data to associate with those URLs (to be used after newDrag). This is an alternative way of setting the metadata: either use the constructor to pass it all at once, or use drag->metaData()["key"] = data; See also: KIO::TransferJob Definition at line 88 of file kurldrag.h. Referenced by KURLDrag().

KURLDrag* KURLDrag::newDrag (  const KURL::List &    urls, const QMap< QString, QString > &    metaData, QWidget *    dragSource = 0, const char *    name = 0 )  [static]

Deprecated: Is equivalent with "new KURLDrag(urls, metaData, dragSource, name)".

KURLDrag* KURLDrag::newDrag (  const KURL::List &    urls, QWidget *    dragSource = 0, const char *    name = 0 )  [static]

Deprecated: Is equivalent with "new KURLDrag(urls, dragSource, name)".

---

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

• kurldrag.h

---