summaryrefslogtreecommitdiffstats
path: root/doc/man/man3/quridrag.3qt
blob: c17749e3fb4cec893a0457341329fdc62b754978 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
'\" t
.TH QUriDrag 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*-
.\" Copyright 1992-2007 Trolltech ASA.  All rights reserved.  See the
.\" license file included in the distribution for a complete license
.\" statement.
.\"
.ad l
.nh
.SH NAME
QUriDrag \- Drag object for a list of URI references
.SH SYNOPSIS
\fC#include <ntqdragobject.h>\fR
.PP
Inherits QStoredDrag.
.PP
.SS "Public Members"
.in +1c
.ti -1c
.BI "\fBQUriDrag\fR ( QStrList uris, QWidget * dragSource = 0, const char * name = 0 )"
.br
.ti -1c
.BI "\fBQUriDrag\fR ( QWidget * dragSource = 0, const char * name = 0 )"
.br
.ti -1c
.BI "\fB~QUriDrag\fR ()"
.br
.ti -1c
.BI "void setFilenames ( const QStringList & fnames )  \fI(obsolete)\fR"
.br
.ti -1c
.BI "void \fBsetFileNames\fR ( const QStringList & fnames )"
.br
.ti -1c
.BI "void \fBsetUnicodeUris\fR ( const QStringList & uuris )"
.br
.ti -1c
.BI "virtual void \fBsetUris\fR ( QStrList uris )"
.br
.in -1c
.SS "Static Public Members"
.in +1c
.ti -1c
.BI "QString \fBuriToLocalFile\fR ( const char * uri )"
.br
.ti -1c
.BI "QCString \fBlocalFileToUri\fR ( const QString & filename )"
.br
.ti -1c
.BI "QString \fBuriToUnicodeUri\fR ( const char * uri )"
.br
.ti -1c
.BI "QCString \fBunicodeUriToUri\fR ( const QString & uuri )"
.br
.ti -1c
.BI "bool \fBcanDecode\fR ( const QMimeSource * e )"
.br
.ti -1c
.BI "bool \fBdecode\fR ( const QMimeSource * e, QStrList & l )"
.br
.ti -1c
.BI "bool \fBdecodeToUnicodeUris\fR ( const QMimeSource * e, QStringList & l )"
.br
.ti -1c
.BI "bool \fBdecodeLocalFiles\fR ( const QMimeSource * e, QStringList & l )"
.br
.in -1c
.SH DESCRIPTION
The QUriDrag class provides a drag object for a list of URI references.
.PP
URIs are a useful way to refer to files that may be distributed across multiple machines. A URI will often refer to a file on a machine local to both the drag source and the drop target, so the URI can be equivalent to passing a file name but is more extensible.
.PP
Use URIs 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.
.PP
You can convert a list of file names to file URIs using setFileNames(), or into human-readble form with setUnicodeUris().
.PP
Static functions are provided to convert between filenames and URIs, e.g. uriToLocalFile() and localFileToUri(), and to and from human-readable form, e.g. uriToUnicodeUri(), unicodeUriToUri(). You can also decode URIs from a mimesource into a list with decodeLocalFiles() and decodeToUnicodeUris().
.PP
See also Drag And Drop Classes.
.SH MEMBER FUNCTION DOCUMENTATION
.SH "QUriDrag::QUriDrag ( QStrList uris, QWidget * dragSource = 0, const char * name = 0 )"
Constructs an object to drag the list of URIs in \fIuris\fR. The \fIdragSource\fR and \fIname\fR arguments are passed on to QStoredDrag. Note that URIs are always in escaped UTF8 encoding.
.SH "QUriDrag::QUriDrag ( QWidget * dragSource = 0, const char * name = 0 )"
Constructs an object to drag. You must call setUris() before you start the drag(). Passes \fIdragSource\fR and \fIname\fR to the QStoredDrag constructor.
.SH "QUriDrag::~QUriDrag ()"
Destroys the object.
.SH "bool QUriDrag::canDecode ( const QMimeSource * e )\fC [static]\fR"
Returns TRUE if decode() would be able to decode \fIe\fR; otherwise returns FALSE.
.SH "bool QUriDrag::decode ( const QMimeSource * e, QStrList & l )\fC [static]\fR"
Decodes URIs from \fIe\fR, placing the result in \fIl\fR (which is first cleared).
.PP
Returns TRUE if \fIe\fR contained a valid list of URIs; otherwise returns FALSE.
.PP
Example: dirview/dirview.cpp.
.SH "bool QUriDrag::decodeLocalFiles ( const QMimeSource * e, QStringList & l )\fC [static]\fR"
Decodes URIs from the mime source event \fIe\fR, converts them to local files if they refer to local files, and places them in \fIl\fR (which is first cleared).
.PP
Returns TRUE if \fIcontained\fR a valid list of URIs; otherwise returns FALSE. The list will be empty if no URIs were local files.
.PP
Example: fileiconview/qfileiconview.cpp.
.SH "bool QUriDrag::decodeToUnicodeUris ( const QMimeSource * e, QStringList & l )\fC [static]\fR"
Decodes URIs from the mime source event \fIe\fR, converts them to Unicode URIs (only useful for displaying to humans), placing them in \fIl\fR (which is first cleared).
.PP
Returns TRUE if \fIcontained\fR a valid list of URIs; otherwise returns FALSE.
.SH "QCString QUriDrag::localFileToUri ( const QString & filename )\fC [static]\fR"
Returns the URI equivalent to the absolute local file \fIfilename\fR.
.PP
See also uriToLocalFile().
.SH "void QUriDrag::setFileNames ( const QStringList & fnames )"
Sets the URIs to be the local-file URIs equivalent to \fIfnames\fR.
.PP
See also localFileToUri() and setUris().
.PP
Example: dirview/dirview.cpp.
.SH "void QUriDrag::setFilenames ( const QStringList & fnames )"
\fBThis function is obsolete.\fR It is provided to keep old source working. We strongly advise against using it in new code.
.PP
Use setFileNames() instead (notice the N).
.SH "void QUriDrag::setUnicodeUris ( const QStringList & uuris )"
Sets the URIs in \fIuuris\fR to be the Unicode URIs (only useful for displaying to humans).
.PP
See also localFileToUri() and setUris().
.SH "void QUriDrag::setUris ( QStrList uris )\fC [virtual]\fR"
Changes the list of \fIuris\fR to be dragged.
.PP
Note that URIs are always in escaped UTF8 encoding.
.SH "QCString QUriDrag::unicodeUriToUri ( const QString & uuri )\fC [static]\fR"
Returns the URI equivalent of the Unicode URI given in \fIuuri\fR (only useful for displaying to humans).
.PP
See also uriToLocalFile().
.SH "QString QUriDrag::uriToLocalFile ( const char * uri )\fC [static]\fR"
Returns the name of a local file equivalent to \fIuri\fR or a null string if \fIuri\fR is not a local file.
.PP
Note that URIs are always in escaped UTF8 encoding.
.PP
See also localFileToUri().
.PP
Example: dirview/dirview.cpp.
.SH "QString QUriDrag::uriToUnicodeUri ( const char * uri )\fC [static]\fR"
Returns the Unicode URI (only useful for displaying to humans) equivalent of \fIuri\fR.
.PP
Note that URIs are always in escaped UTF8 encoding.
.PP
See also localFileToUri().

.SH "SEE ALSO"
.BR http://doc.trolltech.com/quridrag.html
.BR http://www.trolltech.com/faq/tech.html
.SH COPYRIGHT
Copyright 1992-2007 Trolltech ASA, http://www.trolltech.com.  See the
license file included in the distribution for a complete license
statement.
.SH AUTHOR
Generated automatically from the source code.
.SH BUGS
If you find a bug in Qt, please report it as described in
.BR http://doc.trolltech.com/bughowto.html .
Good bug reports help us to help you. Thank you.
.P
The definitive Qt documentation is provided in HTML format; it is
located at $QTDIR/doc/html and can be read using Qt Assistant or with
a web browser. This man page is provided as a convenience for those
users who prefer man pages, although this format is not officially
supported by Trolltech. 
.P
If you find errors in this manual page, please report them to
.BR qt-bugs@trolltech.com .
Please include the name of the manual page (quridrag.3qt) and the Qt
version (3.3.8).