class KURLDrag

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 )
• virtual  ~KURLDrag ()
• QMap<QString, QString> & metaData ()

Public Static Methods

• static KURLDrag *  newDrag ( const KURL::List &urls, QWidget* dragSource = 0, const char * name = 0 )
• static KURLDrag *  newDrag ( const KURL::List &urls, const QMap<QString, QString>& metaData, QWidget* dragSource = 0, const char * name = 0 )
• static bool  decode ( const QMimeSource *e, KURL::List &urls )
• static bool  decode ( const QMimeSource *e, KURL::List &urls, QMap<QString,QString>& metaData )
• static bool  decode ( QStringList const &e, KURL::List &uris )

Protected Methods

•  KURLDrag ( const QStrList & urls, const QMap<QString,QString>& metaData, QWidget * dragSource, const char* name )
• virtual const char *  format ( int i ) const
• virtual QByteArray  encodedData ( const char* mime ) const

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.

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.

Constructs an object to drag the list of URLs in urls. This version also includes metadata.

[virtual]

[static]

[static]

Meta-data to associate with those URLs (to be used after newDrag)

See also: KIO::TransferJob, etc., 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;

[static]

Convenience method that decodes the contents of e into a list of KURLs.

[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.

[static]

Convenience method that decodes the contents of e into a list of KURLs for Qt versions without a MIME clipboard.

[protected]

Protected constructor - use newDrag

[protected const virtual]

[protected const virtual]