qurloperator.html

来自「QT 下载资料仅供参考」· HTML 代码 · 共 511 行 · 第 1/3 页

is listed and <a href="#finished">finished</a>() is emitted after the last one. The
<a href="#newChildren">newChildren</a>() signal is emitted for each list of new entries. If
an error occurs, the signal finished() is emitted, so be sure to
check the state of the network operation pointer.
<p> Because the operation may not be executed immediately, a pointer
to the <a href="qnetworkoperation.html">QNetworkOperation</a> object created by this function is
returned. This object contains all the data about the operation
and is used to refer to this operation later (e.g. in the signals
that are emitted by the QUrlOperator). The return value can also
be 0 if the operation object couldn't be created.
<p> The path of this QUrlOperator must to point to a directory
(because the children of this directory will be listed), not to a
file.

<h3 class=fn>const&nbsp;<a href="qnetworkoperation.html">QNetworkOperation</a>&nbsp;* <a name="mkdir"></a>QUrlOperator::mkdir ( const&nbsp;<a href="qstring.html">QString</a>&nbsp;&amp;&nbsp;dirname )<tt> [virtual]</tt>
</h3>
Tries to create a directory (child) with the name <em>dirname</em>. If
it is successful, a <a href="#newChildren">newChildren</a>() signal with the new child is
emitted, and the <a href="#createdDirectory">createdDirectory</a>() signal with the information
about the new child is also emitted. The <a href="#finished">finished</a>() signal (with
success or failure) is emitted after the operation has been
processed, so check the state of the network operation object to
see whether or not the operation was successful.
<p> Because the operation will not be executed immediately, a pointer
to the <a href="qnetworkoperation.html">QNetworkOperation</a> object created by this function is
returned. This object contains all the data about the operation
and is used to refer to this operation later (e.g. in the signals
that are emitted by the QUrlOperator). The return value can also
be 0 if the operation object couldn't be created.
<p> The path of this QUrlOperator must to point to a directory (not a
file) because the new directory will be created in this path.

<h3 class=fn><a href="qstring.html">QString</a> <a name="nameFilter"></a>QUrlOperator::nameFilter () const
</h3>
Returns the name filter of the URL.
<p> <p>See also <a href="#setNameFilter">QUrlOperator::setNameFilter</a>() and <a href="qdir.html#nameFilter">QDir::nameFilter</a>().

<h3 class=fn>void <a name="newChildren"></a>QUrlOperator::newChildren ( const&nbsp;<a href="qvaluelist.html">QValueList</a>&lt;QUrlInfo&gt;&nbsp;&amp;&nbsp;i, <a href="qnetworkoperation.html">QNetworkOperation</a>&nbsp;*&nbsp;op )<tt> [signal]</tt>
</h3>

<p> This signal is emitted after <a href="#listChildren">listChildren</a>() was called and new
children (i.e. files) have been read from a list of files. <em>i</em>
holds the information about the new files. <em>op</em> is a pointer
to the operation object which contains all the information about
the operation, including the state.
<p> <p>See also <a href="qnetworkoperation.html">QNetworkOperation</a> and <a href="qnetworkprotocol.html">QNetworkProtocol</a>.

<h3 class=fn>const&nbsp;<a href="qnetworkoperation.html">QNetworkOperation</a>&nbsp;* <a name="put"></a>QUrlOperator::put ( const&nbsp;<a href="qbytearray.html">QByteArray</a>&nbsp;&amp;&nbsp;data, const&nbsp;<a href="qstring.html">QString</a>&nbsp;&amp;&nbsp;location = QString::null )<tt> [virtual]</tt>
</h3>
This function tells the network protocol to put <em>data</em> in <em>location</em>. If <em>location</em> is empty (QString::null), it puts the <em>data</em> in the location to which the URL points. What happens depends
on the network protocol. Depending on the network protocol, some
data might come back after putting data, in which case the <a href="#data">data</a>()
signal is emitted. The <a href="#dataTransferProgress">dataTransferProgress</a>() signal is emitted
during processing of the operation. At the end, <a href="#finished">finished</a>() (with
success or failure) is emitted, so check the state of the network
operation object to see whether or not the operation was
successful.
<p> If <em>location</em> is <a href="qstring.html#QString-null">QString::null</a>, the path of this QUrlOperator
should point to a file when you use this operation. If <em>location</em>
is not empty, it can be a relative (a child of the path to which
the QUrlOperator points) or an absolute URL.
<p> For putting some data to a file you can do the following:
<p> <pre>
    QUrlOperator op( "ftp://ftp.whatever.com/home/me/filename.dat" );
    op.<a href="#put">put</a>( data );
    </pre>
 
<p> For most other operations, the path of the QUrlOperator must point
to a directory. If you want to upload data to a file you could do
the following:
<p> <pre>
    QUrlOperator op( "ftp://ftp.whatever.com/home/me" );
    // do some other stuff like op.<a href="#listChildren">listChildren</a>() or op.<a href="#mkdir">mkdir</a>( "new_dir" )
    op.<a href="#put">put</a>( data, "filename.dat" );
    </pre>
 
<p> This will upload the data to ftp://ftp.whatever.com/home/me/filename.dat.
<p> <p>See also <a href="#copy">copy</a>().

<h3 class=fn>const&nbsp;<a href="qnetworkoperation.html">QNetworkOperation</a>&nbsp;* <a name="remove"></a>QUrlOperator::remove ( const&nbsp;<a href="qstring.html">QString</a>&nbsp;&amp;&nbsp;filename )<tt> [virtual]</tt>
</h3>
Tries to remove the file (child) <em>filename</em>. If it succeeds the
<a href="#removed">removed</a>() signal is emitted. <a href="#finished">finished</a>() (with success or failure)
is also emitted after the operation has been processed, so check
the state of the network operation object to see whether or not
the operation was successful.
<p> Because the operation will not be executed immediately, a pointer
to the <a href="qnetworkoperation.html">QNetworkOperation</a> object created by this function is
returned. This object contains all the data about the operation
and is used to refer to this operation later (e.g. in the signals
that are emitted by the QUrlOperator). The return value can also
be 0 if the operation object couldn't be created.
<p> The path of this QUrlOperator must point to a directory; because
if <em>filename</em> is relative, it will try to remove it in this
directory.

<h3 class=fn>void <a name="removed"></a>QUrlOperator::removed ( <a href="qnetworkoperation.html">QNetworkOperation</a>&nbsp;*&nbsp;op )<tt> [signal]</tt>
</h3>

<p> This signal is emitted when <a href="#remove">remove</a>() has been succesful and the
file has been removed.
<p> <em>op</em> is a pointer to the operation object which contains all the
information about the operation, including the state.
<tt>op-&gt;arg(0)</tt> holds the name of the file that was removed.
<p> <p>See also <a href="qnetworkoperation.html">QNetworkOperation</a> and <a href="qnetworkprotocol.html">QNetworkProtocol</a>.

<h3 class=fn>const&nbsp;<a href="qnetworkoperation.html">QNetworkOperation</a>&nbsp;* <a name="rename"></a>QUrlOperator::rename ( const&nbsp;<a href="qstring.html">QString</a>&nbsp;&amp;&nbsp;oldname, const&nbsp;<a href="qstring.html">QString</a>&nbsp;&amp;&nbsp;newname )<tt> [virtual]</tt>
</h3>
Tries to rename the file (child) called <em>oldname</em> to <em>newname</em>.
If it succeeds, the <a href="#itemChanged">itemChanged</a>() signal is emitted. <a href="#finished">finished</a>()
(with success or failure) is also emitted after the operation has
been processed, so check the state of the network operation object
to see whether or not the operation was successful.
<p> Because the operation may not be executed immediately, a pointer
to the <a href="qnetworkoperation.html">QNetworkOperation</a> object created by this function is
returned. This object contains all the data about the operation
and is used to refer to this operation later (e.g. in the signals
that are emitted by the QUrlOperator). The return value can also
be 0 if the operation object couldn't be created.
<p> This path of this QUrlOperator must to point to a directory
because <em>oldname</em> and <em>newname</em> are handled relative to this
directory.

<h3 class=fn>void <a name="setNameFilter"></a>QUrlOperator::setNameFilter ( const&nbsp;<a href="qstring.html">QString</a>&nbsp;&amp;&nbsp;nameFilter )<tt> [virtual]</tt>
</h3>
Sets the name filter of the URL to <em>nameFilter</em>.
<p> <p>See also <a href="qdir.html#setNameFilter">QDir::setNameFilter</a>().

<h3 class=fn>void <a name="start"></a>QUrlOperator::start ( <a href="qnetworkoperation.html">QNetworkOperation</a>&nbsp;*&nbsp;op )<tt> [signal]</tt>
</h3>

<p> Some operations (such as <a href="#listChildren">listChildren</a>()) emit this signal when
they start processing the operation. <em>op</em> is a pointer to the
operation object which contains all the information about the
operation, including the state.
<p> <p>See also <a href="qnetworkoperation.html">QNetworkOperation</a> and <a href="qnetworkprotocol.html">QNetworkProtocol</a>.

<h3 class=fn>void <a name="startedNextCopy"></a>QUrlOperator::startedNextCopy ( const&nbsp;<a href="qptrlist.html">QPtrList</a>&lt;QNetworkOperation&gt;&nbsp;&amp;&nbsp;lst )<tt> [signal]</tt>
</h3>

<p> This signal is emitted if <a href="#copy">copy</a>() starts a new copy operation. <em>lst</em> contains all QNetworkOperations related to this copy
operation.
<p> <p>See also <a href="#copy">copy</a>().

<h3 class=fn>void <a name="stop"></a>QUrlOperator::stop ()<tt> [virtual]</tt>
</h3>
Stops the current network operation and removes all this
QUrlOperator's waiting network operations.

<hr><h2>Related Functions</h2>
<h3 class=fn>void <a name="qInitNetworkProtocols"></a>qInitNetworkProtocols ()
</h3>

<p> This function registers the network protocols for FTP and HTTP. You have to
call this function before you use QUrlOperator for these protocols.
<p> This function is declared in <a href="qnetwork-h.html">qnetwork.h</a>.

<!-- eof -->
<hr><p>
This file is part of the <a href="index.html">Qt toolkit</a>.
Copyright &copy; 1995-2002
<a href="http://www.trolltech.com/">Trolltech</a>. All Rights Reserved.<p><address><hr><div align=center>
<table width=100% cellspacing=0 border=0><tr>
<td>Copyright &copy; 2002 
<a href="http://www.trolltech.com">Trolltech</a><td><a href="http://www.trolltech.com/trademarks.html">Trademarks</a>
<td align=right><div align=right>Qt version 3.0.5</div>
</table></div></address></body>
</html>