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.
= 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().
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).
Man(1) output converted with
man2html