QUriDrag Class Reference

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

#include <qdragobject.h>

Inherits QStoredDrag.

List of all member functions.

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 ) 

Detailed Description

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().

Search the documentation, FAQ, qt-interest archive and more (uses www.trolltech.com):

This file is part of the Qt toolkit, copyright © 1995-2005 Trolltech, all rights reserved.