QUriDrag(3qt)

NAME
QUriDrag - Provides for drag-and-drop of a list of URI references

#include <qdragobject.h>

Inherits QStoredDrag.

  Public Members
QUriDrag ( QStrList uris, QWidget * dragSource = 0, const char * name = 0 )
QUriDrag ( QWidget * dragSource = 0, const char * name = 0 )
~QUriDrag ()
void setFilenames ( QStringList fnames )
void setUnicodeUris ( QStringList uuris )
virtual void setUris ( QStrList uris )

  Static Public Members
QString uriToLocalFile ( const char * )
QCString localFileToUri ( const QString & )
QString uriToUnicodeUri ( const char * )
QCString unicodeUriToUri ( const QString & )
bool canDecode ( const QMimeSource * e )
bool decode ( const QMimeSource * e, QStrList & i )
bool decodeToUnicodeUris ( const QMimeSource * e, QStringList & i )
bool decodeLocalFiles ( const QMimeSource * e, QStringList & i )

DESCRIPTION
Provides for drag-and-drop of a list of URI references.

URIs are a useful way to refer to files that may be distributed across multiple machines. Much of the time a URI will refer to a file on a machine local to both the drag source and the drop target, and so the URI will be equivalent to passing a filename, but more extensible.

While presenting URIs to the user, use them in Unicode form so that the user can comfortably edit and view them. For use in HTTP or other protocols, use the correctly escaped ASCII form (see.

MEMBER FUNCTION DOCUMENTATION

QUriDrag::QUriDrag ( QStrList uris, QWidget * dragSource = 0, const char * name = 0 )
Constructs an object to drag the list of URIs in uris. The dragSource and name arguments are passed on to QStoredDrag. Note that URIs are always in escaped UTF8 encoding, as defined by the W3C.

QUriDrag::QUriDrag ( QWidget * dragSource = 0, const char * name = 0 )
Constructs a object to drag. You will need to call setUris() before you start the drag().

QUriDrag::~QUriDrag ()
Destructs the object.

bool QUriDrag::canDecode ( const QMimeSource * e ) [static]
Returns TRUE if decode() would be able to decode e.

bool QUriDrag::decode ( const QMimeSource * e, QStrList & l ) [static]
Decodes URIs from e, placing the result in l (which is first cleared).

Returns TRUE if the event contained a valid list of URIs.

bool QUriDrag::decodeLocalFiles ( const QMimeSource * e, QStringList & l ) [static]
Decodes URIs from e, converts them to local files if they refer to local files, and places them in l (which is first cleared).

Returns TRUE if the event contained a valid list of URIs. The list will be empty if no URIs were local files.

bool QUriDrag::decodeToUnicodeUris ( const QMimeSource * e, QStringList & l ) [static]
Decodes URIs from e, converts them to Unicode URIs (only useful for displaying to humans), placing them in l (which is first cleared).

Returns TRUE if the event contained a valid list of URIs.

QCString QUriDrag::localFileToUri ( const QString & filename ) [static]
Returns the URI equivalent to the absolute local file filename.

See also uriToLocalFile().

void QUriDrag::setFilenames ( QStringList fnames )
Sets the URIs to be the local-file URIs equivalent to fnames.

See also localFileToUri() and setUris().

void QUriDrag::setUnicodeUris ( QStringList uuris )
Sets the URIs to be the Unicode URIs (only useful for displaying to humans) uuris.

See also localFileToUri() and setUris().

void QUriDrag::setUris ( QStrList uris ) [virtual]
Changes the list of uris to be dragged.

QCString QUriDrag::unicodeUriToUri ( const QString & uuri ) [static]
Returns the URI equivalent to the Unicode URI (only useful for displaying to humans). uuri.

See also uriToLocalFile().

QString QUriDrag::uriToLocalFile ( const char * uri ) [static]
Returns the name of a local file equivalent to uri, or a null string if uri is not a local file.

See also localFileToUri().

QString QUriDrag::uriToUnicodeUri ( const char * uri ) [static]
Returns the Unicode URI (only useful for displaying to humans) equivalent to uri.

See also localFileToUri().

SEE ALSO
http://doc.trolltech.com/quridrag.html http://www.trolltech.com/faq/tech.html

COPYRIGHT
Copyright 1992-2001 Trolltech AS, http://www.trolltech.com. See the license file included in the distribution for a complete license statement.

AUTHOR
Generated automatically from the source code.

BUGS
If you find a bug in Qt, please report it as described in http://doc.trolltech.com/bughowto.html. Good bug reports make our job much simpler. Thank you.

In case of content or formattting problems with this manual page, please report them to qt-bugs@trolltech.com. Please include the name of the manual page (quridrag.3qt) and the Qt version (2.3.1).