Sophie

Sophie

distrib > Mandriva > current > i586 > media > main-updates > by-pkgid > b77dda48f87d4eda8cc559e40c49a652 > files > 283

python-kde4-doc-4.4.5-0.2mdv2010.2.i586.rpm

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">

<head>
  <title>KJob</title>
  <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
  <meta http-equiv="Content-Style-Type" content="text/css" />
  <link rel="stylesheet" type="text/css" href="../common/doxygen.css" />
  <link rel="stylesheet" media="screen" type="text/css" title="KDE Colors" href="../common/kde.css" />
</head>
<body>
<div id="container">
<div id="header">
  <div id="header_top">
    <div>
      <div>
        <img alt ="" src="../common/top-kde.jpg"/>
        KDE 4.4 PyKDE API Reference
      </div>
    </div>
  </div>
  <div id="header_bottom">
    <div id="location">
      <ul>
        <li>KDE's Python API</li>
      </ul>
    </div>

    <div id="menu">
      <ul>
        <li><a href="../modules.html">Overview</a></li>
<li><a href="http://techbase.kde.org/Development/Languages/Python">PyKDE Home</a></li>
<li><a href="http://kde.org/family/">Sitemap</a></li>
<li><a href="http://kde.org/contact/">Contact Us</a></li>
</ul>
    </div>
  </div>
</div>

<div id="body_wrapper">
<div id="body">
<div id="right">
<div class="content">
<div id="main">
<div class="clearer">&nbsp;</div>

<h1>KJob Class Reference</h1>
<code>from PyKDE4.kdecore import *</code>
<p>
Inherits: <a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qobject.html">QObject</a><br />
Subclasses: <a href="../kdecore/KCompositeJob.html">KCompositeJob</a><br />

<h2>Detailed Description</h2>

<p>The base class for all jobs.
For all jobs created in an application, the code looks like
</p>
<p>
<pre class="fragment">
 void SomeClass.methodWithAsynchronousJobCall()
 {
   KJob * job = someoperation( some parameters );
   connect( job, SIGNAL( result( KJob * ) ),
            this, SLOT( handleResult( KJob * ) ) );
   job-&gt;start();
 }
</pre>
(other connects, specific to the job)
</p>
<p>
And handleResult is usually at least:
</p>
<p>
<pre class="fragment">
 void SomeClass.handleResult( KJob *job )
 {
   if ( job-&gt;error() )
       doSomething();
 }
</pre>
</p>
<p>
With the synchronous interface the code looks like
</p>
<p>
<pre class="fragment">
 void SomeClass.methodWithSynchronousJobCall()
 {
   KJob *job = someoperation( some parameters );
   if ( !job-&gt;exec() )
   {
       // An error occurred
   }
   else
   {
       // Do something
   }
 }
</pre>
</p>
<p>
@note: KJob and its subclasses is meant to be used
in a fire-and-forget way. It's deleting itself when
it has finished using deleteLater() so the job
instance disappears after the next event loop run.
</p>
<table border="0" cellpadding="0" cellspacing="0"><tr><td colspan="2"><br><h2>Enumerations</h2></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="#obj232298796">&lt;anonymous&gt;</a>&nbsp;</td><td class="memItemRight" valign="bottom">{&nbsp;NoError, KilledJobError, UserDefinedError&nbsp;}</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="#Capability">Capability</a>&nbsp;</td><td class="memItemRight" valign="bottom">{&nbsp;NoCapabilities, Killable, Suspendable&nbsp;}</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="#KillVerbosity">KillVerbosity</a>&nbsp;</td><td class="memItemRight" valign="bottom">{&nbsp;Quietly, EmitResult&nbsp;}</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="#Unit">Unit</a>&nbsp;</td><td class="memItemRight" valign="bottom">{&nbsp;Bytes, Files, Directories&nbsp;}</td></tr>
<tr><td colspan="2"><br><h2>Signals</h2></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="#description">description</a> (, <a href="../kdecore/KJob.html">KJob</a> job, <a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> title, QPair<QString,QString> field1=qMakePair(QString(),QString()), QPair<QString,QString> field2=qMakePair(QString(),QString()))</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="#infoMessage">infoMessage</a> (, <a href="../kdecore/KJob.html">KJob</a> job, <a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> plain, <a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> rich=QString())</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="#warning">warning</a> (, <a href="../kdecore/KJob.html">KJob</a> job, <a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> plain, <a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> rich=QString())</td></tr>
<tr><td colspan="2"><br><h2>Methods</h2></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="#KJob">__init__</a> (self, <a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qobject.html">QObject</a> parent=0)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a href="../kdecore/KJob.Capabilities.html">KJob.Capabilities</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="#capabilities">capabilities</a> (self)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="#description">description</a> (self, <a href="../kdecore/KJob.html">KJob</a> job, <a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> title, QPair<QString,QString> field1=qMakePair(QString(),QString()), QPair<QString,QString> field2=qMakePair(QString(),QString()))</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">bool&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="#doKill">doKill</a> (self)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">bool&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="#doResume">doResume</a> (self)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">bool&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="#doSuspend">doSuspend</a> (self)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="#emitPercent">emitPercent</a> (self, long processedAmount, long totalAmount)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="#emitResult">emitResult</a> (self)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="#emitSpeed">emitSpeed</a> (self, long speed)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="#error">error</a> (self)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="#errorString">errorString</a> (self)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="#errorText">errorText</a> (self)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">bool&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="#exec">exec_</a> (self)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="#infoMessage">infoMessage</a> (self, <a href="../kdecore/KJob.html">KJob</a> job, <a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> plain, <a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> rich=QString())</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">bool&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="#isAutoDelete">isAutoDelete</a> (self)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">bool&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="#isSuspended">isSuspended</a> (self)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">bool&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="#kill">kill</a> (self, <a href="../kdecore/KJob.html#KillVerbosity">KJob.KillVerbosity</a> verbosity=KJob.Quietly)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">long&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="#percent">percent</a> (self)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">long&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="#processedAmount">processedAmount</a> (self, <a href="../kdecore/KJob.html#Unit">KJob.Unit</a> unit)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">bool&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="#resume">resume</a> (self)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="#setAutoDelete">setAutoDelete</a> (self, bool autodelete)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="#setCapabilities">setCapabilities</a> (self, <a href="../kdecore/KJob.Capabilities.html">KJob.Capabilities</a> capabilities)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="#setError">setError</a> (self, int errorCode)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="#setErrorText">setErrorText</a> (self, <a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> errorText)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="#setPercent">setPercent</a> (self, long percentage)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="#setProcessedAmount">setProcessedAmount</a> (self, <a href="../kdecore/KJob.html#Unit">KJob.Unit</a> unit, long amount)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="#setTotalAmount">setTotalAmount</a> (self, <a href="../kdecore/KJob.html#Unit">KJob.Unit</a> unit, long amount)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="#setUiDelegate">setUiDelegate</a> (self, <a href="../kdecore/KJobUiDelegate.html">KJobUiDelegate</a> delegate)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="#start">start</a> (self)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">bool&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="#suspend">suspend</a> (self)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">long&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="#totalAmount">totalAmount</a> (self, <a href="../kdecore/KJob.html#Unit">KJob.Unit</a> unit)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a href="../kdecore/KJobUiDelegate.html">KJobUiDelegate</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="#uiDelegate">uiDelegate</a> (self)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="#warning">warning</a> (self, <a href="../kdecore/KJob.html">KJob</a> job, <a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> plain, <a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> rich=QString())</td></tr>
</table>
<hr><h2>Method Documentation</h2><a class="anchor" name="KJob"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname">__init__</td>
<td>(</td>
<td class="paramtype">&nbsp;<em>self</em>, </td>
<td class="paramname"></td>
</tr><tr>
<td class="memname"></td>
<td></td>
<td class="paramtype"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qobject.html">QObject</a>&nbsp;</td>
<td class="paramname"><em>parent=0</em></td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td>
<td></td>
<td width="100%"> </td>
</tr></table>
</div>
<div class="memdoc"><p>Creates a new KJob object.
</p>
<p>
</p><dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign="top"><em>parent</em>&nbsp;</td><td> the parent QObject
</td></tr>
</table></dl>
<p>
</p></div></div><a class="anchor" name="capabilities"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname"><a href="../kdecore/KJob.Capabilities.html">KJob.Capabilities</a> capabilities</td>
<td>(</td>
<td class="paramtype">&nbsp;</td>
<td class="paramname"><em>self</em>&nbsp;)</td>
<td width="100%"> </td>
</tr>
</table>
</div>
<div class="memdoc"><p>Returns the capabilities of this job.
</p>
<p>
<dl class="return" compact><dt><b>Returns:</b></dt><dd> the capabilities that this job supports
</dd></dl> <dl class="see" compact><dt><b>See also:</b></dt><dd> setCapabilities()
</dd></dl>
</p></div></div><a class="anchor" name="description"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname"> description</td>
<td>(</td>
<td class="paramtype">&nbsp;<em>self</em>, </td>
<td class="paramname"></td>
</tr><tr>
<td class="memname"></td>
<td></td>
<td class="paramtype"><a href="../kdecore/KJob.html">KJob</a>&nbsp;</td>
<td class="paramname"><em>job</em>, </td>
</tr>
<tr>
<td class="memname"></td>
<td></td>
<td class="paramtype"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a>&nbsp;</td>
<td class="paramname"><em>title</em>, </td>
</tr>
<tr>
<td class="memname"></td>
<td></td>
<td class="paramtype">QPair<QString,QString>&nbsp;</td>
<td class="paramname"><em>field1=qMakePair(QString(),QString())</em>, </td>
</tr>
<tr>
<td class="memname"></td>
<td></td>
<td class="paramtype">QPair<QString,QString>&nbsp;</td>
<td class="paramname"><em>field2=qMakePair(QString(),QString())</em></td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td>
<td></td>
<td width="100%"> </td>
</tr></table>
</div>
<div class="memdoc"><p>Emitted to display general description of this job. A description has
a title and two optional fields which can be used to complete the
description.
</p>
<p>
Examples of titles are "Copying", "Creating resource", etc.
The fields of the description can be "Source" with an URL, and,
"Destination" with an URL for a "Copying" description.
</p><dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign="top"><em>job</em>&nbsp;</td><td> the job that emitted this signal

<tr><td></td><td valign="top"><em>title</em>&nbsp;</td><td> the general description of the job

<tr><td></td><td valign="top"><em>field1</em>&nbsp;</td><td> first field (localized name and value)

<tr><td></td><td valign="top"><em>field2</em>&nbsp;</td><td> second field (localized name and value)
</td></tr>
</table></dl>
<p>
</p><dl compact><dt><b>Signal syntax:</b></dt><dd><code>QObject.connect(source, SIGNAL("description(KJob*, const QString&, const QPair<QString,QString>&, const QPair<QString,QString>&)"), target_slot)</code></dd></dl></div></div><a class="anchor" name="doKill"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname">bool doKill</td>
<td>(</td>
<td class="paramtype">&nbsp;</td>
<td class="paramname"><em>self</em>&nbsp;)</td>
<td width="100%"> </td>
</tr>
</table>
</div>
<div class="memdoc"><p>Aborts this job quietly.
This simply kills the job, no error reporting or job deletion should be involved.
</p>
<p>
<dl class="return" compact><dt><b>Returns:</b></dt><dd> true if the operation is supported and succeeded, false otherwise
</dd></dl>
</p></div></div><a class="anchor" name="doResume"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname">bool doResume</td>
<td>(</td>
<td class="paramtype">&nbsp;</td>
<td class="paramname"><em>self</em>&nbsp;)</td>
<td width="100%"> </td>
</tr>
</table>
</div>
<div class="memdoc"><p>Resumes this job.
</p>
<p>
<dl class="return" compact><dt><b>Returns:</b></dt><dd> true if the operation is supported and succeeded, false otherwise
</dd></dl>
</p></div></div><a class="anchor" name="doSuspend"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname">bool doSuspend</td>
<td>(</td>
<td class="paramtype">&nbsp;</td>
<td class="paramname"><em>self</em>&nbsp;)</td>
<td width="100%"> </td>
</tr>
</table>
</div>
<div class="memdoc"><p>Suspends this job.
</p>
<p>
<dl class="return" compact><dt><b>Returns:</b></dt><dd> true if the operation is supported and succeeded, false otherwise
</dd></dl>
</p></div></div><a class="anchor" name="emitPercent"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname"> emitPercent</td>
<td>(</td>
<td class="paramtype">&nbsp;<em>self</em>, </td>
<td class="paramname"></td>
</tr><tr>
<td class="memname"></td>
<td></td>
<td class="paramtype">long&nbsp;</td>
<td class="paramname"><em>processedAmount</em>, </td>
</tr>
<tr>
<td class="memname"></td>
<td></td>
<td class="paramtype">long&nbsp;</td>
<td class="paramname"><em>totalAmount</em></td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td>
<td></td>
<td width="100%"> </td>
</tr></table>
</div>
<div class="memdoc"><p>Utility function for inherited jobs.
Emits the percent signal if bigger than previous value,
after calculating it from the parameters.
</p>
<p>
</p><dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign="top"><em>processedAmount</em>&nbsp;</td><td> the processed amount

<tr><td></td><td valign="top"><em>totalAmount</em>&nbsp;</td><td> the total amount
</td></tr> </table></dl>
<p> <dl class="see" compact><dt><b>See also:</b></dt><dd> percent()
</dd></dl>
</p></div></div><a class="anchor" name="emitResult"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname"> emitResult</td>
<td>(</td>
<td class="paramtype">&nbsp;</td>
<td class="paramname"><em>self</em>&nbsp;)</td>
<td width="100%"> </td>
</tr>
</table>
</div>
<div class="memdoc"><p>Utility function to emit the result signal, and suicide this job.
It first notifies the observers to hide the progress for this job using
the finished() signal.
</p>
<p>
@note: Deletes this job using deleteLater().
</p>
<p>
<dl class="see" compact><dt><b>See also:</b></dt><dd> result()
</dd></dl> <dl class="see" compact><dt><b>See also:</b></dt><dd> finished()
</dd></dl>
</p></div></div><a class="anchor" name="emitSpeed"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname"> emitSpeed</td>
<td>(</td>
<td class="paramtype">&nbsp;<em>self</em>, </td>
<td class="paramname"></td>
</tr><tr>
<td class="memname"></td>
<td></td>
<td class="paramtype">long&nbsp;</td>
<td class="paramname"><em>speed</em></td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td>
<td></td>
<td width="100%"> </td>
</tr></table>
</div>
<div class="memdoc"><p>Utility function for inherited jobs.
Emits the speed signal and starts the timer for removing that info
</p>
<p>
</p><dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign="top"><em>speed</em>&nbsp;</td><td> the speed in bytes/s
</td></tr>
</table></dl>
<p>
</p></div></div><a class="anchor" name="error"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname">int error</td>
<td>(</td>
<td class="paramtype">&nbsp;</td>
<td class="paramname"><em>self</em>&nbsp;)</td>
<td width="100%"> </td>
</tr>
</table>
</div>
<div class="memdoc"><p>Returns the error code, if there has been an error.
Only call this method from the slot connected to result().
</p>
<p>
<dl class="return" compact><dt><b>Returns:</b></dt><dd> the error code for this job, 0 if no error.
</dd></dl>
</p></div></div><a class="anchor" name="errorString"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> errorString</td>
<td>(</td>
<td class="paramtype">&nbsp;</td>
<td class="paramname"><em>self</em>&nbsp;)</td>
<td width="100%"> </td>
</tr>
</table>
</div>
<div class="memdoc"><p>Converts an error code and a non-i18n error message into an
error message in the current language. The low level (non-i18n)
error message (usually a url) is put into the translated error
message using %1.
</p>
<p>
Example for errid == ERR_CANNOT_OPEN_FOR_READING:
<pre class="fragment">
   i18n( "Could not read\n%1" , errorText() );
</pre>
Only call if error is not 0.
</p>
<p>
<dl class="return" compact><dt><b>Returns:</b></dt><dd> the error message and if there is no error, a message
telling the user that the app is broken, so check with
error() whether there is an error
</dd></dl>
</p></div></div><a class="anchor" name="errorText"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> errorText</td>
<td>(</td>
<td class="paramtype">&nbsp;</td>
<td class="paramname"><em>self</em>&nbsp;)</td>
<td width="100%"> </td>
</tr>
</table>
</div>
<div class="memdoc"><p>Returns the error text if there has been an error.
Only call if error is not 0.
This is really internal, better use errorString.
</p>
<p>
<dl class="return" compact><dt><b>Returns:</b></dt><dd> a string to help understand the error, usually the url
related to the error. Only valid if error() is not 0.
</dd></dl>
</p></div></div><a class="anchor" name="exec"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname">bool exec_</td>
<td>(</td>
<td class="paramtype">&nbsp;</td>
<td class="paramname"><em>self</em>&nbsp;)</td>
<td width="100%"> </td>
</tr>
</table>
</div>
<div class="memdoc"><p>Executes the job synchronously.
</p>
<p>
<dl class="return" compact><dt><b>Returns:</b></dt><dd> true if the job has been executed without error, false otherwise
</dd></dl>
</p></div></div><a class="anchor" name="infoMessage"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname"> infoMessage</td>
<td>(</td>
<td class="paramtype">&nbsp;<em>self</em>, </td>
<td class="paramname"></td>
</tr><tr>
<td class="memname"></td>
<td></td>
<td class="paramtype"><a href="../kdecore/KJob.html">KJob</a>&nbsp;</td>
<td class="paramname"><em>job</em>, </td>
</tr>
<tr>
<td class="memname"></td>
<td></td>
<td class="paramtype"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a>&nbsp;</td>
<td class="paramname"><em>plain</em>, </td>
</tr>
<tr>
<td class="memname"></td>
<td></td>
<td class="paramtype"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a>&nbsp;</td>
<td class="paramname"><em>rich=QString()</em></td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td>
<td></td>
<td width="100%"> </td>
</tr></table>
</div>
<div class="memdoc"><p>Emitted to display state information about this job.
Examples of message are "Resolving host", "Connecting to host...", etc.
</p>
<p>
</p><dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign="top"><em>job</em>&nbsp;</td><td> the job that emitted this signal

<tr><td></td><td valign="top"><em>plain</em>&nbsp;</td><td> the info message

<tr><td></td><td valign="top"><em>rich</em>&nbsp;</td><td> the rich text version of the message, or QString() is none is available
</td></tr>
</table></dl>
<p>
</p><dl compact><dt><b>Signal syntax:</b></dt><dd><code>QObject.connect(source, SIGNAL("infoMessage(KJob*, const QString&, const QString&)"), target_slot)</code></dd></dl></div></div><a class="anchor" name="isAutoDelete"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname">bool isAutoDelete</td>
<td>(</td>
<td class="paramtype">&nbsp;</td>
<td class="paramname"><em>self</em>&nbsp;)</td>
<td width="100%"> </td>
</tr>
</table>
</div>
<div class="memdoc"><p>Returns whether this job automatically deletes itself once
the job is finished.
</p>
<p>
<dl class="return" compact><dt><b>Returns:</b></dt><dd> whether the job is deleted automatically after
finishing.
</dd></dl>
</p></div></div><a class="anchor" name="isSuspended"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname">bool isSuspended</td>
<td>(</td>
<td class="paramtype">&nbsp;</td>
<td class="paramname"><em>self</em>&nbsp;)</td>
<td width="100%"> </td>
</tr>
</table>
</div>
<div class="memdoc"><p>Returns if the job was suspended with the suspend() call.
</p>
<p>
<dl class="return" compact><dt><b>Returns:</b></dt><dd> if the job was suspended
</dd></dl> <dl class="see" compact><dt><b>See also:</b></dt><dd> suspend() resume()
</dd></dl>
</p></div></div><a class="anchor" name="kill"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname">bool kill</td>
<td>(</td>
<td class="paramtype">&nbsp;<em>self</em>, </td>
<td class="paramname"></td>
</tr><tr>
<td class="memname"></td>
<td></td>
<td class="paramtype"><a href="../kdecore/KJob.html#KillVerbosity">KJob.KillVerbosity</a>&nbsp;</td>
<td class="paramname"><em>verbosity=KJob.Quietly</em></td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td>
<td></td>
<td width="100%"> </td>
</tr></table>
</div>
<div class="memdoc"><p>Aborts this job.
This kills and deletes the job.
</p>
<p>
</p><dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign="top"><em>verbosity</em>&nbsp;</td><td> if equals to EmitResult, Job will emit signal result
and ask uiserver to close the progress window.
<b>verbosity</b> is set to EmitResult for subjobs. Whether applications
should call with Quietly or EmitResult depends on whether they rely
on result being emitted or not. Please notice that if <b>verbosity</b> is
set to Quietly, signal result will NOT be emitted.
</td></tr> </table></dl>
<p> <dl class="return" compact><dt><b>Returns:</b></dt><dd> true if the operation is supported and succeeded, false otherwise
</dd></dl>
</p></div></div><a class="anchor" name="percent"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname">long percent</td>
<td>(</td>
<td class="paramtype">&nbsp;</td>
<td class="paramname"><em>self</em>&nbsp;)</td>
<td width="100%"> </td>
</tr>
</table>
</div>
<div class="memdoc"><p>Progress signal showing the overall progress of the job
This is valid for any kind of job, and allows using a
a progress bar very easily. (see KProgressBar).
Note that this signal is not emitted for finished jobs.
</p>
<p>
This is a private signal, it can't be emitted directly by subclasses of
KJob, use emitPercent(), setPercent() setTotalAmount() or
setProcessedAmount() instead.
</p>
<p>
</p><dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign="top"><em>job</em>&nbsp;</td><td> the job that emitted this signal

<tr><td></td><td valign="top"><em>percent</em>&nbsp;</td><td> the percentage
</td></tr>
</table></dl>
<p>
</p></div></div><a class="anchor" name="processedAmount"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname">long processedAmount</td>
<td>(</td>
<td class="paramtype">&nbsp;<em>self</em>, </td>
<td class="paramname"></td>
</tr><tr>
<td class="memname"></td>
<td></td>
<td class="paramtype"><a href="../kdecore/KJob.html#Unit">KJob.Unit</a>&nbsp;</td>
<td class="paramname"><em>unit</em></td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td>
<td></td>
<td width="100%"> </td>
</tr></table>
</div>
<div class="memdoc"><p>Regularly emitted to show the progress of this job by giving the current amount.
The unit of this amount is sent too. It can be emitted several times if the job
manages several different units.
</p>
<p>
This is a private signal, it can't be emitted directly by subclasses of
KJob, use setProcessedAmount() instead.
</p>
<p>
</p><dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign="top"><em>job</em>&nbsp;</td><td> the job that emitted this signal

<tr><td></td><td valign="top"><em>unit</em>&nbsp;</td><td> the unit of the processed amount

<tr><td></td><td valign="top"><em>amount</em>&nbsp;</td><td> the processed amount
</td></tr>
</table></dl>
<p>
</p></div></div><a class="anchor" name="resume"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname">bool resume</td>
<td>(</td>
<td class="paramtype">&nbsp;</td>
<td class="paramname"><em>self</em>&nbsp;)</td>
<td width="100%"> </td>
</tr>
</table>
</div>
<div class="memdoc"><p>Resumes this job.
</p>
<p>
<dl class="return" compact><dt><b>Returns:</b></dt><dd> true if the operation is supported and succeeded, false otherwise
</dd></dl>
</p></div></div><a class="anchor" name="setAutoDelete"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname"> setAutoDelete</td>
<td>(</td>
<td class="paramtype">&nbsp;<em>self</em>, </td>
<td class="paramname"></td>
</tr><tr>
<td class="memname"></td>
<td></td>
<td class="paramtype">bool&nbsp;</td>
<td class="paramname"><em>autodelete</em></td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td>
<td></td>
<td width="100%"> </td>
</tr></table>
</div>
<div class="memdoc"><p>set the auto-delete property of the job. If <b>autodelete</b> is
set to false the job will not delete itself once it is finished.
</p>
<p>
The default for any KJob is to automatically delete itself.
</p>
<p>
</p><dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign="top"><em>autodelete</em>&nbsp;</td><td> set to false to disable automatic deletion
of the job.
</td></tr>
</table></dl>
<p>
</p></div></div><a class="anchor" name="setCapabilities"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname"> setCapabilities</td>
<td>(</td>
<td class="paramtype">&nbsp;<em>self</em>, </td>
<td class="paramname"></td>
</tr><tr>
<td class="memname"></td>
<td></td>
<td class="paramtype"><a href="../kdecore/KJob.Capabilities.html">KJob.Capabilities</a>&nbsp;</td>
<td class="paramname"><em>capabilities</em></td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td>
<td></td>
<td width="100%"> </td>
</tr></table>
</div>
<div class="memdoc"><p>Sets the capabilities for this job.
</p>
<p>
</p><dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign="top"><em>capabilities</em>&nbsp;</td><td> are the capabilities supported by this job
</td></tr> </table></dl>
<p> <dl class="see" compact><dt><b>See also:</b></dt><dd> capabilities()
</dd></dl>
</p></div></div><a class="anchor" name="setError"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname"> setError</td>
<td>(</td>
<td class="paramtype">&nbsp;<em>self</em>, </td>
<td class="paramname"></td>
</tr><tr>
<td class="memname"></td>
<td></td>
<td class="paramtype">int&nbsp;</td>
<td class="paramname"><em>errorCode</em></td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td>
<td></td>
<td width="100%"> </td>
</tr></table>
</div>
<div class="memdoc"><p>Sets the error code. It should be called when an error
is encountered in the job, just before calling emitResult().
</p>
<p>
</p><dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign="top"><em>errorCode</em>&nbsp;</td><td> the error code
</td></tr> </table></dl>
<p> <dl class="see" compact><dt><b>See also:</b></dt><dd> emitResult()
</dd></dl>
</p></div></div><a class="anchor" name="setErrorText"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname"> setErrorText</td>
<td>(</td>
<td class="paramtype">&nbsp;<em>self</em>, </td>
<td class="paramname"></td>
</tr><tr>
<td class="memname"></td>
<td></td>
<td class="paramtype"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a>&nbsp;</td>
<td class="paramname"><em>errorText</em></td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td>
<td></td>
<td width="100%"> </td>
</tr></table>
</div>
<div class="memdoc"><p>Sets the error text. It should be called when an error
is encountered in the job, just before calling emitResult().
</p>
<p>
</p><dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign="top"><em>errorText</em>&nbsp;</td><td> the error text
</td></tr> </table></dl>
<p> <dl class="see" compact><dt><b>See also:</b></dt><dd> emitResult()
</dd></dl>
</p></div></div><a class="anchor" name="setPercent"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname"> setPercent</td>
<td>(</td>
<td class="paramtype">&nbsp;<em>self</em>, </td>
<td class="paramname"></td>
</tr><tr>
<td class="memname"></td>
<td></td>
<td class="paramtype">long&nbsp;</td>
<td class="paramname"><em>percentage</em></td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td>
<td></td>
<td width="100%"> </td>
</tr></table>
</div>
<div class="memdoc"><p>Sets the overall progress of the job. The percent() signal
is emitted if the value changed.
</p>
<p>
</p><dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign="top"><em>percentage</em>&nbsp;</td><td> the new overall progress
</td></tr>
</table></dl>
<p>
</p></div></div><a class="anchor" name="setProcessedAmount"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname"> setProcessedAmount</td>
<td>(</td>
<td class="paramtype">&nbsp;<em>self</em>, </td>
<td class="paramname"></td>
</tr><tr>
<td class="memname"></td>
<td></td>
<td class="paramtype"><a href="../kdecore/KJob.html#Unit">KJob.Unit</a>&nbsp;</td>
<td class="paramname"><em>unit</em>, </td>
</tr>
<tr>
<td class="memname"></td>
<td></td>
<td class="paramtype">long&nbsp;</td>
<td class="paramname"><em>amount</em></td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td>
<td></td>
<td width="100%"> </td>
</tr></table>
</div>
<div class="memdoc"><p>Sets the processed size. The processedAmount() and percent() signals
are emitted if the values changed. The percent() signal is emitted
only for the progress unit.
</p>
<p>
</p><dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign="top"><em>unit</em>&nbsp;</td><td> the unit of the new processed amount

<tr><td></td><td valign="top"><em>amount</em>&nbsp;</td><td> the new processed amount
</td></tr>
</table></dl>
<p>
</p></div></div><a class="anchor" name="setTotalAmount"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname"> setTotalAmount</td>
<td>(</td>
<td class="paramtype">&nbsp;<em>self</em>, </td>
<td class="paramname"></td>
</tr><tr>
<td class="memname"></td>
<td></td>
<td class="paramtype"><a href="../kdecore/KJob.html#Unit">KJob.Unit</a>&nbsp;</td>
<td class="paramname"><em>unit</em>, </td>
</tr>
<tr>
<td class="memname"></td>
<td></td>
<td class="paramtype">long&nbsp;</td>
<td class="paramname"><em>amount</em></td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td>
<td></td>
<td width="100%"> </td>
</tr></table>
</div>
<div class="memdoc"><p>Sets the total size. The totalSize() and percent() signals
are emitted if the values changed. The percent() signal is emitted
only for the progress unit.
</p>
<p>
</p><dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign="top"><em>unit</em>&nbsp;</td><td> the unit of the new total amount

<tr><td></td><td valign="top"><em>amount</em>&nbsp;</td><td> the new total amount
</td></tr>
</table></dl>
<p>
</p></div></div><a class="anchor" name="setUiDelegate"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname"> setUiDelegate</td>
<td>(</td>
<td class="paramtype">&nbsp;<em>self</em>, </td>
<td class="paramname"></td>
</tr><tr>
<td class="memname"></td>
<td></td>
<td class="paramtype"><a href="../kdecore/KJobUiDelegate.html">KJobUiDelegate</a>&nbsp;</td>
<td class="paramname"><em>delegate</em></td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td>
<td></td>
<td width="100%"> </td>
</tr></table>
</div>
<div class="memdoc"><p>Attach a UI delegate to this job.
</p>
<p>
If the job had another UI delegate, it's automatically deleted. Once
attached to the job, the UI delegate will be deleted with the job.
</p>
<p>
</p><dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign="top"><em>delegate</em>&nbsp;</td><td> the new UI delegate to use
</td></tr> </table></dl>
<p> <dl class="see" compact><dt><b>See also:</b></dt><dd> KJobUiDelegate
</dd></dl>
</p></div></div><a class="anchor" name="start"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname"> start</td>
<td>(</td>
<td class="paramtype">&nbsp;</td>
<td class="paramname"><em>self</em>&nbsp;)</td>
<td width="100%"> </td>
</tr>
</table>
</div>
<div class="memdoc"><dl compact><dt><b>Abstract method:</b></dt><dd>This method is abstract and can be overridden but not called directly.</dd></dl><p>Starts the job asynchronously. When the job is finished,
result() is emitted.
</p>
<p>
Warning: Never implement any synchronous workload in this method. This method
should just trigger the job startup, not do any work itself. It is expected to
be non-blocking.
</p>
<p>
This is the method all subclasses need to implement.
It should setup and trigger the workload of the job. It should not do any
work itself. This includes all signals and terminating the job, e.g. by
emitResult(). The workload, which could be another method of the
subclass, is to be triggered using the event loop, e.g. by code like:
<pre class="fragment">
 void ExampleJob.start()
 {
  QTimer.singleShot( 0, this, SLOT( doWork() ) );
 }
</pre>
</p></div></div><a class="anchor" name="suspend"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname">bool suspend</td>
<td>(</td>
<td class="paramtype">&nbsp;</td>
<td class="paramname"><em>self</em>&nbsp;)</td>
<td width="100%"> </td>
</tr>
</table>
</div>
<div class="memdoc"><p>Suspends this job.
The job should be kept in a state in which it is possible to resume it.
</p>
<p>
<dl class="return" compact><dt><b>Returns:</b></dt><dd> true if the operation is supported and succeeded, false otherwise
</dd></dl>
</p></div></div><a class="anchor" name="totalAmount"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname">long totalAmount</td>
<td>(</td>
<td class="paramtype">&nbsp;<em>self</em>, </td>
<td class="paramname"></td>
</tr><tr>
<td class="memname"></td>
<td></td>
<td class="paramtype"><a href="../kdecore/KJob.html#Unit">KJob.Unit</a>&nbsp;</td>
<td class="paramname"><em>unit</em></td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td>
<td></td>
<td width="100%"> </td>
</tr></table>
</div>
<div class="memdoc"><p>Emitted when we know the amount the job will have to process. The unit of this
amount is sent too. It can be emitted several times if the job manages several
different units.
</p>
<p>
This is a private signal, it can't be emitted directly by subclasses of
KJob, use setTotalAmount() instead.
</p>
<p>
</p><dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign="top"><em>job</em>&nbsp;</td><td> the job that emitted this signal

<tr><td></td><td valign="top"><em>unit</em>&nbsp;</td><td> the unit of the total amount

<tr><td></td><td valign="top"><em>amount</em>&nbsp;</td><td> the total amount
</td></tr>
</table></dl>
<p>
</p></div></div><a class="anchor" name="uiDelegate"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname"><a href="../kdecore/KJobUiDelegate.html">KJobUiDelegate</a> uiDelegate</td>
<td>(</td>
<td class="paramtype">&nbsp;</td>
<td class="paramname"><em>self</em>&nbsp;)</td>
<td width="100%"> </td>
</tr>
</table>
</div>
<div class="memdoc"><p>Retrieves the delegate attached to this job.
</p>
<p>
<dl class="return" compact><dt><b>Returns:</b></dt><dd> the delegate attached to this job, or 0 if there's no such delegate
</dd></dl>
</p></div></div><a class="anchor" name="warning"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname"> warning</td>
<td>(</td>
<td class="paramtype">&nbsp;<em>self</em>, </td>
<td class="paramname"></td>
</tr><tr>
<td class="memname"></td>
<td></td>
<td class="paramtype"><a href="../kdecore/KJob.html">KJob</a>&nbsp;</td>
<td class="paramname"><em>job</em>, </td>
</tr>
<tr>
<td class="memname"></td>
<td></td>
<td class="paramtype"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a>&nbsp;</td>
<td class="paramname"><em>plain</em>, </td>
</tr>
<tr>
<td class="memname"></td>
<td></td>
<td class="paramtype"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a>&nbsp;</td>
<td class="paramname"><em>rich=QString()</em></td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td>
<td></td>
<td width="100%"> </td>
</tr></table>
</div>
<div class="memdoc"><p>Emitted to display a warning about this job.
</p>
<p>
</p><dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign="top"><em>job</em>&nbsp;</td><td> the job that emitted this signal

<tr><td></td><td valign="top"><em>plain</em>&nbsp;</td><td> the warning message

<tr><td></td><td valign="top"><em>rich</em>&nbsp;</td><td> the rich text version of the message, or QString() is none is available
</td></tr>
</table></dl>
<p>
</p><dl compact><dt><b>Signal syntax:</b></dt><dd><code>QObject.connect(source, SIGNAL("warning(KJob*, const QString&, const QString&)"), target_slot)</code></dd></dl></div></div><hr><h2>Enumeration Documentation</h2><a class="anchor" name="obj232298796"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr><td class="memname">anonymous</td>
</tr>
</table>
</div>
<div class="memdoc"><dl compact><dt><b>Enumerator: </b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0"><tr><td valign="top"><em>NoError</em>&nbsp;</td><td><tr><td valign="top"><em>KilledJobError</em>&nbsp;</td><td><tr><td valign="top"><em>UserDefinedError</em>&nbsp;</td><td></table>
</dl>
</div></div><p><a class="anchor" name="Capability"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr><td class="memname">Capability</td>
</tr>
</table>
</div>
<div class="memdoc"><dl compact><dt><b>Enumerator: </b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0"><tr><td valign="top"><em>NoCapabilities</em>&nbsp;=&nbsp;0x0000</td><td><tr><td valign="top"><em>Killable</em>&nbsp;=&nbsp;0x0001</td><td><tr><td valign="top"><em>Suspendable</em>&nbsp;=&nbsp;0x0002</td><td></table>
</dl>
</div></div><p><a class="anchor" name="KillVerbosity"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr><td class="memname">KillVerbosity</td>
</tr>
</table>
</div>
<div class="memdoc"><dl compact><dt><b>Enumerator: </b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0"><tr><td valign="top"><em>Quietly</em>&nbsp;</td><td><tr><td valign="top"><em>EmitResult</em>&nbsp;</td><td></table>
</dl>
</div></div><p><a class="anchor" name="Unit"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr><td class="memname">Unit</td>
</tr>
</table>
</div>
<div class="memdoc"><dl compact><dt><b>Enumerator: </b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0"><tr><td valign="top"><em>Bytes</em>&nbsp;</td><td><tr><td valign="top"><em>Files</em>&nbsp;</td><td><tr><td valign="top"><em>Directories</em>&nbsp;</td><td></table>
</dl>
</div></div><p>
</div>
</div>
</div>

<div id="left">

<div class="menu_box">
<div class="nav_list">
<ul>
<li><a href="../allclasses.html">Full Index</a></li>
</ul>
</div>

<a name="cp-menu" /><div class="menutitle"><div>
  <h2 id="cp-menu-project">Modules</h2>
</div></div>
<div class="nav_list">
<ul><li><a href="../akonadi/index.html">akonadi</a></li>
<li><a href="../dnssd/index.html">dnssd</a></li>
<li><a href="../kdecore/index.html">kdecore</a></li>
<li><a href="../kdeui/index.html">kdeui</a></li>
<li><a href="../khtml/index.html">khtml</a></li>
<li><a href="../kio/index.html">kio</a></li>
<li><a href="../knewstuff/index.html">knewstuff</a></li>
<li><a href="../kparts/index.html">kparts</a></li>
<li><a href="../kutils/index.html">kutils</a></li>
<li><a href="../nepomuk/index.html">nepomuk</a></li>
<li><a href="../phonon/index.html">phonon</a></li>
<li><a href="../plasma/index.html">plasma</a></li>
<li><a href="../polkitqt/index.html">polkitqt</a></li>
<li><a href="../solid/index.html">solid</a></li>
<li><a href="../soprano/index.html">soprano</a></li>
</ul></div></div>

</div>

</div>
  <div class="clearer"/>
</div>

<div id="end_body"></div>
</div>
<div id="footer"><div id="footer_text">
This documentation is maintained by <a href="&#109;&#97;&#105;&#108;&#116;&#111;&#58;simon&#64;simonzone&#46;com">Simon Edwards</a>.<br />
        KDE<sup>&#174;</sup> and <a href="../images/kde_gear_black.png">the K Desktop Environment<sup>&#174;</sup> logo</a> are registered trademarks of <a href="http://ev.kde.org/" title="Homepage of the KDE non-profit Organization">KDE e.V.</a> |
        <a href="http://www.kde.org/contact/impressum.php">Legal</a>
    </div></div>
</body>
</html>