<?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_US" xml:lang="en_US">
<head>
<title>kio/kio: KDirLister Class Reference (kio/kio)</title>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta http-equiv="Content-Style-Type" content="text/css" />
<meta http-equiv="pics-label" content='(pics-1.1 "http://www.icra.org/ratingsv02.html" comment "ICRAonline DE v2.0" l gen true for "http://www.kde.org" r (nz 1 vz 1 lz 1 oz 1 cb 1) "http://www.rsac.org/ratingsv01.html" l gen true for "http://www.kde.org" r (n 0 s 0 v 0 l 0))' />
<meta name="trademark" content="KDE e.V." />
<meta name="description" content="K Desktop Environment Homepage, KDE.org" />
<meta name="MSSmartTagsPreventParsing" content="true" />
<meta name="robots" content="all" />
<link rel="shortcut icon" href="../../../favicon.ico" />
<link rel="stylesheet" media="screen" type="text/css" title="APIDOX" href="doxygen.css" />
</head>
<body>
<div id="nav_header_top" align="right">
<a href="#content" class="doNotDisplay" accesskey="2">Skip to main content ::</a>
<a href="../../.."><img id="nav_header_logo" alt="Home" align="left" src="../../../kde_gear_64.png" border="0" /></a>
<span class="doNotDisplay">::</span>
<div id="nav_header_title" align="left">KDE API Reference</div>
</div>
<div id="nav_header_bottom" align="right">
<span class="doNotDisplay">:: <a href="#navigation" accesskey="5">Skip to Link Menu</a><br/></span>
<div id="nav_header_bottom_right" style="text-align: left;">
/ <a href="../../..">API Reference</a>
/ <a href="../../html/index.html">kio</a> / <a href=".">kio</a>
</div>
</div>
<table id="main" border="0" cellpadding="0" cellspacing="0" width="100%">
<tr>
<td valign="top" class="menuheader" height="0"></td>
<td id="contentcolumn" valign="top" rowspan="2" >
<div id="content" style="padding-top: 0px;"><div style="width:100%; margin: 0px; padding: 0px;">
<a name="content"></a>
<!-- Generated by Doxygen 1.7.4 -->
</div>
<div class="header">
<div class="summary">
<a href="#pub-types">Public Types</a> |
<a href="#signals">Signals</a> |
<a href="#pub-methods">Public Member Functions</a> |
<a href="#pro-types">Protected Types</a> |
<a href="#pro-methods">Protected Member Functions</a> |
<a href="#properties">Properties</a> |
<a href="#friends">Friends</a> </div>
<div class="headertitle">
<div class="title">KDirLister Class Reference</div> </div>
</div>
<div class="contents">
<!-- doxytag: class="KDirLister" --><!-- doxytag: inherits="QObject" -->
<p>The dir lister deals with the kiojob used to list and update a directory and has signals for the user of this class (e.g.
<a href="classKDirLister.html#details">More...</a></p>
<p><code>#include <<a class="el" href="kdirlister_8h_source.html">kdirlister.h</a>></code></p>
<div class="dynheader">
Inheritance diagram for KDirLister:</div>
<div class="dyncontent">
<div class="center">
<img src="classKDirLister.png" usemap="#KDirLister_map" alt=""/>
<map id="KDirLister_map" name="KDirLister_map">
<area href="qobject.html" alt="QObject" shape="rect" coords="0,0,68,24"/>
</map>
</div></div>
<p><a href="classKDirLister-members.html">List of all members.</a></p>
<table class="memberdecls">
<tr><td colspan="2"><h2><a name="pub-types"></a>
Public Types</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">enum  </td><td class="memItemRight" valign="bottom"><a class="el" href="classKDirLister.html#acc57ea947dbdad050ae2dff2504b7417">WhichItems</a> { <b>AllItems</b> = 0,
<b>FilteredItems</b> = 1
}</td></tr>
<tr><td colspan="2"><h2><a name="signals"></a>
Signals</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classKDirLister.html#aae4ffaa085ea8b729b1bf5faa2b831af">started</a> (const KURL &_url)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classKDirLister.html#a6f3e769b242066ad4fd00493ae5b11f9">completed</a> ()</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classKDirLister.html#a9b08d3eb783de2528d363be1a683e973">completed</a> (const KURL &_url)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classKDirLister.html#a645cccfa087d9d2917aaf4d1903d694d">canceled</a> ()</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classKDirLister.html#a8876095a5f477606a479fd44037a6d39">canceled</a> (const KURL &_url)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classKDirLister.html#aef3eb22d2967600b21407d76a88abce0">redirection</a> (const KURL &_url)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classKDirLister.html#ac17abdd2a3849f8d0c21b3f41bc4f9f2">redirection</a> (const KURL &oldUrl, const KURL &newUrl)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classKDirLister.html#a97dbbb27f096eace54f66aca71c71712">clear</a> ()</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classKDirLister.html#ae81822165915ff58f455e7f484502c94">clear</a> (const KURL &_url)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classKDirLister.html#a104efac5272478c3f8a0e17c4d2603e2">newItems</a> (const <a class="elRef" href="qptrlist.html">KFileItemList</a> &items)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classKDirLister.html#abf7f660cc84c80d38ecf39bd212b0e5c">itemsFilteredByMime</a> (const <a class="elRef" href="qptrlist.html">KFileItemList</a> &items)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classKDirLister.html#a7da4dd595cf52875059acf2ebb8d6f0a">deleteItem</a> (<a class="el" href="classKFileItem.html">KFileItem</a> *_fileItem)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classKDirLister.html#a8e34d037df6e0c8ed593dc50c5fa3699">refreshItems</a> (const <a class="elRef" href="qptrlist.html">KFileItemList</a> &items)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classKDirLister.html#a56d13724f06b70a13694b95360c2529e">infoMessage</a> (const <a class="elRef" href="qstring.html">QString</a> &msg)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classKDirLister.html#ad6d72cadd198ba5fe511a1157b807f81">percent</a> (int percent)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classKDirLister.html#a584ab2bf1ed098a5f773a46928e65b1d">totalSize</a> (<a class="el" href="namespaceKIO.html#a90b418366ba9052c97d4dca845026f43">KIO::filesize_t</a> size)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classKDirLister.html#a89c3b02de4bedc4be40ba67770b7d742">processedSize</a> (<a class="el" href="namespaceKIO.html#a90b418366ba9052c97d4dca845026f43">KIO::filesize_t</a> size)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classKDirLister.html#a16639c0ca11242d3f58a9c4451d8b317">speed</a> (int bytes_per_second)</td></tr>
<tr><td colspan="2"><h2><a name="pub-methods"></a>
Public Member Functions</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classKDirLister.html#a87ac885b99e79a5e875199bf76dd76fb">KDirLister</a> (bool _delayedMimeTypes=false)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual </td><td class="memItemRight" valign="bottom"><a class="el" href="classKDirLister.html#a96e9f092899c1fb3e4b938b236b8c1dc">~KDirLister</a> ()</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classKDirLister.html#a0da1c19a8d5d49aa0d95e4f036310aa9">openURL</a> (const KURL &_url, bool _keep=false, bool _reload=false)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><a class="el" href="classKDirLister.html#a900b66e2f5f96b59ec09b1327bb0e903">stop</a> ()</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><a class="el" href="classKDirLister.html#a1143f8f50647ae8db68396128b04c44e">stop</a> (const KURL &_url)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classKDirLister.html#ace9a143025fc16f13daff4038c843e0f">autoUpdate</a> () const </td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><a class="el" href="classKDirLister.html#abe7cc2e18929b3d357a045de9665f9e8">setAutoUpdate</a> (bool enable)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classKDirLister.html#a1d57294cce42d3bc61106014833f4124">autoErrorHandlingEnabled</a> () const </td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classKDirLister.html#a818588f30d84bd8751dbf3af1c88182d">setAutoErrorHandlingEnabled</a> (bool enable, <a class="elRef" href="qwidget.html">QWidget</a> *<a class="elRef" href="qobject.html#parent">parent</a>)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classKDirLister.html#a93994daf20757a1bdb639869310f9eda">showingDotFiles</a> () const </td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><a class="el" href="classKDirLister.html#ab3ec5ca80a8994a3f66addc25b43b5b2">setShowingDotFiles</a> (bool _showDotFiles)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classKDirLister.html#acc82b23203d446da5254b4981d543894">dirOnlyMode</a> () const </td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><a class="el" href="classKDirLister.html#a6589dc9c9f2e40daf3344d5b39c8eda0">setDirOnlyMode</a> (bool dirsOnly)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">const KURL & </td><td class="memItemRight" valign="bottom"><a class="el" href="classKDirLister.html#a2bc08feafe10112d92e7e025f3f24ff7">url</a> () const </td></tr>
<tr><td class="memItemLeft" align="right" valign="top">const KURL::List & </td><td class="memItemRight" valign="bottom"><a class="el" href="classKDirLister.html#a7fc0744bb0473cd3458e509736819ca7">directories</a> () const </td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><a class="el" href="classKDirLister.html#a5c1e23dfa61137b1961aa421b4af881d">emitChanges</a> ()</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><a class="el" href="classKDirLister.html#aa3d94820e6e4b25c6bf1a3b01a959f5d">updateDirectory</a> (const KURL &_dir)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classKDirLister.html#a1ad8ceef2a17b05e49eebc20ffb49676">isFinished</a> () const </td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="classKFileItem.html">KFileItem</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="classKDirLister.html#a3fe843e980a7fba8ebee81182d096ae1">rootItem</a> () const </td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual <a class="el" href="classKFileItem.html">KFileItem</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="classKDirLister.html#a367a7294880bdc0fda581e615f149a2f">findByURL</a> (const KURL &_url) const </td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="aa34f89372378f4063333cbdb05b2668c"></a><!-- doxytag: member="KDirLister::find" ref="aa34f89372378f4063333cbdb05b2668c" args="(const KURL &_url) const " -->
<a class="el" href="classKFileItem.html">KFileItem</a> * </td><td class="memItemRight" valign="bottom"><b>find</b> (const KURL &_url) const </td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual <a class="el" href="classKFileItem.html">KFileItem</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="classKDirLister.html#a8928d1d619349a39ff644d947df3a589">findByName</a> (const <a class="elRef" href="qstring.html">QString</a> &<a class="elRef" href="qobject.html#name">name</a>) const </td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><a class="el" href="classKDirLister.html#a83e03aac346a9018b6c9f9ea0f1f8d1f">setNameFilter</a> (const <a class="elRef" href="qstring.html">QString</a> &filter)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">const <a class="elRef" href="qstring.html">QString</a> & </td><td class="memItemRight" valign="bottom"><a class="el" href="classKDirLister.html#a30e6cecd5a769e169c29a65905014d83">nameFilter</a> () const </td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><a class="el" href="classKDirLister.html#a33faab3d8e542d26c47b42a56e969e6e">setMimeFilter</a> (const <a class="elRef" href="qstringlist.html">QStringList</a> &mimeList)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classKDirLister.html#a8c08401869f4a852cb631c70c90e6ac3">setMimeExcludeFilter</a> (const <a class="elRef" href="qstringlist.html">QStringList</a> &mimeList)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><a class="el" href="classKDirLister.html#a54def76e01106f37064c25fe00604386">clearMimeFilter</a> ()</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">const <a class="elRef" href="qstringlist.html">QStringList</a> & </td><td class="memItemRight" valign="bottom"><a class="el" href="classKDirLister.html#a1d5e080c3acc5ccc8e9f69e5ef9ac165">mimeFilters</a> () const </td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classKDirLister.html#a8d27452e10d439aa130ab87f24b459d5">matchesFilter</a> (const <a class="elRef" href="qstring.html">QString</a> &<a class="elRef" href="qobject.html#name">name</a>) const </td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classKDirLister.html#a27ab680407efa259292a7fba55098f5b">matchesMimeFilter</a> (const <a class="elRef" href="qstring.html">QString</a> &mime) const </td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classKDirLister.html#a246a31e6b1d6c3bcaa2bdcf36d44d180">setMainWindow</a> (<a class="elRef" href="qwidget.html">QWidget</a> *window)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="qwidget.html">QWidget</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="classKDirLister.html#a113ef9f1cfda144ea8c827212d5c5a6d">mainWindow</a> ()</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="qptrlist.html">KFileItemList</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classKDirLister.html#a550fcff5e967f079ec81ea00421f8357">items</a> (<a class="el" href="classKDirLister.html#acc57ea947dbdad050ae2dff2504b7417">WhichItems</a> which=FilteredItems) const </td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="qptrlist.html">KFileItemList</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classKDirLister.html#a00a23ba6e0d4c5a7d99afcc0798fc7ed">itemsForDir</a> (const KURL &dir, <a class="el" href="classKDirLister.html#acc57ea947dbdad050ae2dff2504b7417">WhichItems</a> which=FilteredItems) const </td></tr>
<tr><td colspan="2"><h2><a name="pro-types"></a>
Protected Types</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">enum  </td><td class="memItemRight" valign="bottom"><b>Changes</b> { <br/>
  <b>NONE</b> = 0,
<b>NAME_FILTER</b> = 1,
<b>MIME_FILTER</b> = 2,
<b>DOT_FILES</b> = 4,
<br/>
  <b>DIR_ONLY_MODE</b> = 8
<br/>
}</td></tr>
<tr><td colspan="2"><h2><a name="pro-methods"></a>
Protected Member Functions</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classKDirLister.html#a630cdb5a3982a34c52098de53216167e">matchesFilter</a> (const <a class="el" href="classKFileItem.html">KFileItem</a> *) const </td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classKDirLister.html#adc94511267a6664728e9e98044ebce66">matchesMimeFilter</a> (const <a class="el" href="classKFileItem.html">KFileItem</a> *) const </td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classKDirLister.html#a8b3163a8f9b692ea2b53aa5ad0b23dc9">doNameFilter</a> (const <a class="elRef" href="qstring.html">QString</a> &<a class="elRef" href="qobject.html#name">name</a>, const <a class="elRef" href="qptrlist.html">QPtrList</a>< <a class="elRef" href="qregexp.html">QRegExp</a> > &filters) const </td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classKDirLister.html#aa3ce3a49e556b87137a1ffee4e6e31e2">doMimeFilter</a> (const <a class="elRef" href="qstring.html">QString</a> &mime, const <a class="elRef" href="qstringlist.html">QStringList</a> &filters) const </td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="addcf9d51d10dac66c6bfe9481a106850"></a><!-- doxytag: member="KDirLister::doMimeExcludeFilter" ref="addcf9d51d10dac66c6bfe9481a106850" args="(const QString &mimeExclude, const QStringList &filters) const " -->
bool </td><td class="memItemRight" valign="bottom"><b>doMimeExcludeFilter</b> (const <a class="elRef" href="qstring.html">QString</a> &mimeExclude, const <a class="elRef" href="qstringlist.html">QStringList</a> &filters) const </td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classKDirLister.html#a67fa9acc51963f71515bf5106cdff8e2">validURL</a> (const KURL &) const </td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><a class="el" href="classKDirLister.html#a01fb96c53cb3f8bc5b1a6b25e7536f1e">handleError</a> (<a class="el" href="classKIO_1_1Job.html">KIO::Job</a> *)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a9e507236b2789fae8e636f196cd840e4"></a><!-- doxytag: member="KDirLister::virtual_hook" ref="a9e507236b2789fae8e636f196cd840e4" args="(int id, void *data)" -->
virtual void </td><td class="memItemRight" valign="bottom"><b>virtual_hook</b> (int id, void *data)</td></tr>
<tr><td colspan="2"><h2><a name="properties"></a>
Properties</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="aa231b095ba2d2f94bd214eaa29838732"></a><!-- doxytag: member="KDirLister::autoUpdate" ref="aa231b095ba2d2f94bd214eaa29838732" args="" -->
bool </td><td class="memItemRight" valign="bottom"><b>autoUpdate</b></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="aee6ef146673aab3b15aa8e80c73f1214"></a><!-- doxytag: member="KDirLister::showingDotFiles" ref="aee6ef146673aab3b15aa8e80c73f1214" args="" -->
bool </td><td class="memItemRight" valign="bottom"><b>showingDotFiles</b></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a77bc395cedf742706e1710ba2e6329df"></a><!-- doxytag: member="KDirLister::dirOnlyMode" ref="a77bc395cedf742706e1710ba2e6329df" args="" -->
bool </td><td class="memItemRight" valign="bottom"><b>dirOnlyMode</b></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="aeb99da342afa3d8989ad53501490cf44"></a><!-- doxytag: member="KDirLister::autoErrorHandlingEnabled" ref="aeb99da342afa3d8989ad53501490cf44" args="" -->
bool </td><td class="memItemRight" valign="bottom"><b>autoErrorHandlingEnabled</b></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a39d19634be58eb49b1934c89aa1f52bd"></a><!-- doxytag: member="KDirLister::nameFilter" ref="a39d19634be58eb49b1934c89aa1f52bd" args="" -->
<a class="elRef" href="qstring.html">QString</a> </td><td class="memItemRight" valign="bottom"><b>nameFilter</b></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a6b2b38a1bd94cd34f9004de4cf5bc52f"></a><!-- doxytag: member="KDirLister::mimeFilter" ref="a6b2b38a1bd94cd34f9004de4cf5bc52f" args="" -->
<a class="elRef" href="qstringlist.html">QStringList</a> </td><td class="memItemRight" valign="bottom"><b>mimeFilter</b></td></tr>
<tr><td colspan="2"><h2><a name="friends"></a>
Friends</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="ae4085374ca992e26767fb123beb2852b"></a><!-- doxytag: member="KDirLister::KDirListerPrivate" ref="ae4085374ca992e26767fb123beb2852b" args="" -->
class </td><td class="memItemRight" valign="bottom"><b>KDirListerPrivate</b></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="aa9a57e7092d9785a5530c737657303fa"></a><!-- doxytag: member="KDirLister::KDirListerCache" ref="aa9a57e7092d9785a5530c737657303fa" args="" -->
class </td><td class="memItemRight" valign="bottom"><b>KDirListerCache</b></td></tr>
</table>
<hr/><a name="details" id="details"></a><h2>Detailed Description</h2>
<div class="textblock"><p>The dir lister deals with the kiojob used to list and update a directory and has signals for the user of this class (e.g. </p>
<p>konqueror view or kdesktop) to create/destroy its items when asked.</p>
<p>This class is independent from the graphical representation of the dir (icon container, tree view, ...) and it stores the items (as KFileItems).</p>
<p>Typical usage : </p>
<ul>
<li>Create an instance. </li>
<li>Connect to at least update, clear, newItem, and deleteItem. </li>
<li>Call openURL - the signals will be called. </li>
<li>Reuse the instance when opening a new url (openURL). </li>
<li>Destroy the instance when not needed anymore (usually destructor).</li>
</ul>
<p>Advanced usage : call openURL with _keep = true to list directories without forgetting the ones previously read (e.g. for a tree view)</p>
<p>Helper class for the kiojob used to list and update a directory. </p>
<dl class="author"><dt><b>Author:</b></dt><dd>Michael Brade <<a href="mailto:brade@kde.org">brade@kde.org</a>> </dd></dl>
<p>Definition at line <a class="el" href="kdirlister_8h_source.html#l00055">55</a> of file <a class="el" href="kdirlister_8h_source.html">kdirlister.h</a>.</p>
</div><hr/><h2>Member Enumeration Documentation</h2>
<a class="anchor" id="acc57ea947dbdad050ae2dff2504b7417"></a><!-- doxytag: member="KDirLister::WhichItems" ref="acc57ea947dbdad050ae2dff2504b7417" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">enum <a class="el" href="classKDirLister.html#acc57ea947dbdad050ae2dff2504b7417">KDirLister::WhichItems</a></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Used by <a class="el" href="classKDirLister.html#a550fcff5e967f079ec81ea00421f8357" title="Returns the items listed for the current url().">items()</a> and <a class="el" href="classKDirLister.html#a00a23ba6e0d4c5a7d99afcc0798fc7ed" title="Returns the items listed for the given dir.">itemsForDir()</a> to specify whether you want all items for a directory or just the filtered ones. </p>
<p>Definition at line <a class="el" href="kdirlister_8h_source.html#l00363">363</a> of file <a class="el" href="kdirlister_8h_source.html">kdirlister.h</a>.</p>
</div>
</div>
<hr/><h2>Constructor & Destructor Documentation</h2>
<a class="anchor" id="a87ac885b99e79a5e875199bf76dd76fb"></a><!-- doxytag: member="KDirLister::KDirLister" ref="a87ac885b99e79a5e875199bf76dd76fb" args="(bool _delayedMimeTypes=false)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">KDirLister::KDirLister </td>
<td>(</td>
<td class="paramtype">bool </td>
<td class="paramname"><em>_delayedMimeTypes</em> = <code>false</code></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Create a directory lister. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">_delayedMimeTypes</td><td>if true, mime types will be fetched on demand. If false, they will always be fetched immediately </td></tr>
</table>
</dd>
</dl>
<p>Definition at line <a class="el" href="kdirlister_8cpp_source.html#l01822">1822</a> of file <a class="el" href="kdirlister_8cpp_source.html">kdirlister.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="a96e9f092899c1fb3e4b938b236b8c1dc"></a><!-- doxytag: member="KDirLister::~KDirLister" ref="a96e9f092899c1fb3e4b938b236b8c1dc" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">KDirLister::~KDirLister </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td><code> [virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Destroy the directory lister. </p>
<p>Definition at line <a class="el" href="kdirlister_8cpp_source.html#l01838">1838</a> of file <a class="el" href="kdirlister_8cpp_source.html">kdirlister.cpp</a>.</p>
</div>
</div>
<hr/><h2>Member Function Documentation</h2>
<a class="anchor" id="a1d57294cce42d3bc61106014833f4124"></a><!-- doxytag: member="KDirLister::autoErrorHandlingEnabled" ref="a1d57294cce42d3bc61106014833f4124" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool KDirLister::autoErrorHandlingEnabled </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Check whether auto error handling is enabled. </p>
<p>If enabled, it will show an error dialog to the user when an error occurs. It is turned on by default. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>true if auto error handling is enabled, false otherwise </dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="classKDirLister.html#a818588f30d84bd8751dbf3af1c88182d" title="Enable or disable auto error handling is enabled.">setAutoErrorHandlingEnabled()</a> </dd></dl>
</div>
</div>
<a class="anchor" id="ace9a143025fc16f13daff4038c843e0f"></a><!-- doxytag: member="KDirLister::autoUpdate" ref="ace9a143025fc16f13daff4038c843e0f" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool KDirLister::autoUpdate </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Checks whether <a class="el" href="classKDirWatch.html" title="Watch directories and files for changes.">KDirWatch</a> will automatically update directories. </p>
<p>This is enabled by default. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>true if <a class="el" href="classKDirWatch.html" title="Watch directories and files for changes.">KDirWatch</a> is used to automatically update directories. </dd></dl>
</div>
</div>
<a class="anchor" id="a645cccfa087d9d2917aaf4d1903d694d"></a><!-- doxytag: member="KDirLister::canceled" ref="a645cccfa087d9d2917aaf4d1903d694d" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void KDirLister::canceled </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td><code> [signal]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Tell the view that the user canceled the listing. </p>
<p>No running jobs are left. </p>
</div>
</div>
<a class="anchor" id="a8876095a5f477606a479fd44037a6d39"></a><!-- doxytag: member="KDirLister::canceled" ref="a8876095a5f477606a479fd44037a6d39" args="(const KURL &_url)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void KDirLister::canceled </td>
<td>(</td>
<td class="paramtype">const KURL & </td>
<td class="paramname"><em>_url</em></td><td>)</td>
<td><code> [signal]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Tell the view that the listing of the directory <code>_url</code> was canceled. </p>
<p>There might be other running jobs left. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">_url</td><td>the directory URL </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="a97dbbb27f096eace54f66aca71c71712"></a><!-- doxytag: member="KDirLister::clear" ref="a97dbbb27f096eace54f66aca71c71712" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void KDirLister::clear </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td><code> [signal]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Signal to clear all items. </p>
<p>It must always be connected to this signal to avoid doubled items! </p>
</div>
</div>
<a class="anchor" id="ae81822165915ff58f455e7f484502c94"></a><!-- doxytag: member="KDirLister::clear" ref="ae81822165915ff58f455e7f484502c94" args="(const KURL &_url)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void KDirLister::clear </td>
<td>(</td>
<td class="paramtype">const KURL & </td>
<td class="paramname"><em>_url</em></td><td>)</td>
<td><code> [signal]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Signal to empty the directory <code>_url</code>. </p>
<p>It is only emitted if the lister is holding more than one directory. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">_url</td><td>the directory that will be emptied </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="a54def76e01106f37064c25fe00604386"></a><!-- doxytag: member="KDirLister::clearMimeFilter" ref="a54def76e01106f37064c25fe00604386" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void KDirLister::clearMimeFilter </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td><code> [virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Clears the mime based filter. </p>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="classKDirLister.html#a33faab3d8e542d26c47b42a56e969e6e" title="Set mime-based filter to only list items matching the given mimetypes.">setMimeFilter</a> </dd></dl>
<p>Definition at line <a class="el" href="kdirlister_8cpp_source.html#l02115">2115</a> of file <a class="el" href="kdirlister_8cpp_source.html">kdirlister.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="a6f3e769b242066ad4fd00493ae5b11f9"></a><!-- doxytag: member="KDirLister::completed" ref="a6f3e769b242066ad4fd00493ae5b11f9" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void KDirLister::completed </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td><code> [signal]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Tell the view that listing is finished. </p>
<p>There are no jobs running anymore. </p>
</div>
</div>
<a class="anchor" id="a9b08d3eb783de2528d363be1a683e973"></a><!-- doxytag: member="KDirLister::completed" ref="a9b08d3eb783de2528d363be1a683e973" args="(const KURL &_url)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void KDirLister::completed </td>
<td>(</td>
<td class="paramtype">const KURL & </td>
<td class="paramname"><em>_url</em></td><td>)</td>
<td><code> [signal]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Tell the view that the listing of the directory <code>_url</code> is finished. </p>
<p>There might be other running jobs left. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">_url</td><td>the directory URL </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="a7da4dd595cf52875059acf2ebb8d6f0a"></a><!-- doxytag: member="KDirLister::deleteItem" ref="a7da4dd595cf52875059acf2ebb8d6f0a" args="(KFileItem *_fileItem)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void KDirLister::deleteItem </td>
<td>(</td>
<td class="paramtype"><a class="el" href="classKFileItem.html">KFileItem</a> * </td>
<td class="paramname"><em>_fileItem</em></td><td>)</td>
<td><code> [signal]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Signal an item to remove. </p>
<p>ATTENTION: if <code>_fileItem</code> == <a class="el" href="classKDirLister.html#a3fe843e980a7fba8ebee81182d096ae1" title="Returns the file item of the URL.">rootItem()</a> the directory this lister is holding was deleted and you HAVE to release especially the <a class="el" href="classKDirLister.html#a3fe843e980a7fba8ebee81182d096ae1" title="Returns the file item of the URL.">rootItem()</a> of this lister, otherwise your app will CRASH!! The <a class="el" href="classKDirLister.html#a97dbbb27f096eace54f66aca71c71712" title="Signal to clear all items.">clear()</a> signals have been emitted already. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">_fileItem</td><td>the fileItem to delete </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="a7fc0744bb0473cd3458e509736819ca7"></a><!-- doxytag: member="KDirLister::directories" ref="a7fc0744bb0473cd3458e509736819ca7" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">const KURL::List & KDirLister::directories </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Returns all URLs that are listed by this <a class="el" href="classKDirLister.html" title="The dir lister deals with the kiojob used to list and update a directory and has signals for the user...">KDirLister</a>. </p>
<p>This is only useful if you called <a class="el" href="classKDirLister.html#a0da1c19a8d5d49aa0d95e4f036310aa9" title="Run the directory lister on the given url.">openURL()</a> with <code>_keep</code> == true, as it happens in a treeview, for example. (Note that the base url is included in the list as well, of course.)</p>
<dl class="return"><dt><b>Returns:</b></dt><dd>the list of all listed URLs </dd></dl>
<dl class="since"><dt><b>Since:</b></dt><dd>3.4 </dd></dl>
<p>Definition at line <a class="el" href="kdirlister_8cpp_source.html#l01936">1936</a> of file <a class="el" href="kdirlister_8cpp_source.html">kdirlister.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="acc82b23203d446da5254b4981d543894"></a><!-- doxytag: member="KDirLister::dirOnlyMode" ref="acc82b23203d446da5254b4981d543894" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool KDirLister::dirOnlyMode </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Checks whether the <a class="el" href="classKDirLister.html" title="The dir lister deals with the kiojob used to list and update a directory and has signals for the user...">KDirLister</a> only lists directories or all files. </p>
<p>By default this option is disabled (all files will be shown). </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>true if setDirOnlyMode(true) was called </dd></dl>
</div>
</div>
<a class="anchor" id="aa3ce3a49e556b87137a1ffee4e6e31e2"></a><!-- doxytag: member="KDirLister::doMimeFilter" ref="aa3ce3a49e556b87137a1ffee4e6e31e2" args="(const QString &mime, const QStringList &filters) const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool KDirLister::doMimeFilter </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> & </td>
<td class="paramname"><em>mime</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="elRef" href="qstringlist.html">QStringList</a> & </td>
<td class="paramname"><em>filters</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td> const<code> [protected, virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Called by the public <a class="el" href="classKDirLister.html#a27ab680407efa259292a7fba55098f5b" title="Checks whether mime matches a filter in the list of mime types.">matchesMimeFilter()</a> to do the actual filtering. </p>
<p>Those methods may be reimplemented to customize filtering. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">mime</td><td>the mime type to filter </td></tr>
<tr><td class="paramname">filters</td><td>the list of mime types to filter </td></tr>
</table>
</dd>
</dl>
<p>Definition at line <a class="el" href="kdirlister_8cpp_source.html#l02179">2179</a> of file <a class="el" href="kdirlister_8cpp_source.html">kdirlister.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="a8b3163a8f9b692ea2b53aa5ad0b23dc9"></a><!-- doxytag: member="KDirLister::doNameFilter" ref="a8b3163a8f9b692ea2b53aa5ad0b23dc9" args="(const QString &name, const QPtrList< QRegExp > &filters) const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool KDirLister::doNameFilter </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> & </td>
<td class="paramname"><em>name</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="elRef" href="qptrlist.html">QPtrList</a>< <a class="elRef" href="qregexp.html">QRegExp</a> > & </td>
<td class="paramname"><em>filters</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td> const<code> [protected, virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Called by the public <a class="el" href="classKDirLister.html#a8d27452e10d439aa130ab87f24b459d5" title="Checks whether name matches a filter in the list of name filters.">matchesFilter()</a> to do the actual filtering. </p>
<p>Those methods may be reimplemented to customize filtering. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">name</td><td>the name to filter </td></tr>
<tr><td class="paramname">filters</td><td>a list of regular expressions for filtering </td></tr>
</table>
</dd>
</dl>
<p>Definition at line <a class="el" href="kdirlister_8cpp_source.html#l02170">2170</a> of file <a class="el" href="kdirlister_8cpp_source.html">kdirlister.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="a5c1e23dfa61137b1961aa421b4af881d"></a><!-- doxytag: member="KDirLister::emitChanges" ref="a5c1e23dfa61137b1961aa421b4af881d" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void KDirLister::emitChanges </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td><code> [virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Actually emit the changes made with setShowingDotFiles, setDirOnlyMode, setNameFilter and setMimeFilter. </p>
<p>Definition at line <a class="el" href="kdirlister_8cpp_source.html#l01941">1941</a> of file <a class="el" href="kdirlister_8cpp_source.html">kdirlister.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="a8928d1d619349a39ff644d947df3a589"></a><!-- doxytag: member="KDirLister::findByName" ref="a8928d1d619349a39ff644d947df3a589" args="(const QString &name) const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classKFileItem.html">KFileItem</a> * KDirLister::findByName </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> & </td>
<td class="paramname"><em>name</em></td><td>)</td>
<td> const<code> [virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Find an item by its name. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">name</td><td>the item name </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>the pointer to the <a class="el" href="classKFileItem.html" title="A KFileItem is a generic class to handle a file, local or remote.">KFileItem</a> </dd></dl>
<p>Definition at line <a class="el" href="kdirlister_8cpp_source.html#l02050">2050</a> of file <a class="el" href="kdirlister_8cpp_source.html">kdirlister.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="a367a7294880bdc0fda581e615f149a2f"></a><!-- doxytag: member="KDirLister::findByURL" ref="a367a7294880bdc0fda581e615f149a2f" args="(const KURL &_url) const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classKFileItem.html">KFileItem</a> * KDirLister::findByURL </td>
<td>(</td>
<td class="paramtype">const KURL & </td>
<td class="paramname"><em>_url</em></td><td>)</td>
<td> const<code> [virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Find an item by its URL. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">_url</td><td>the item URL </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>the pointer to the <a class="el" href="classKFileItem.html" title="A KFileItem is a generic class to handle a file, local or remote.">KFileItem</a> </dd></dl>
<p>Definition at line <a class="el" href="kdirlister_8cpp_source.html#l02045">2045</a> of file <a class="el" href="kdirlister_8cpp_source.html">kdirlister.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="a01fb96c53cb3f8bc5b1a6b25e7536f1e"></a><!-- doxytag: member="KDirLister::handleError" ref="a01fb96c53cb3f8bc5b1a6b25e7536f1e" args="(KIO::Job *)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void KDirLister::handleError </td>
<td>(</td>
<td class="paramtype"><a class="el" href="classKIO_1_1Job.html">KIO::Job</a> * </td>
<td class="paramname"><em>job</em></td><td>)</td>
<td><code> [protected, virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Reimplement to customize error handling. </p>
<p>Definition at line <a class="el" href="kdirlister_8cpp_source.html#l02215">2215</a> of file <a class="el" href="kdirlister_8cpp_source.html">kdirlister.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="a56d13724f06b70a13694b95360c2529e"></a><!-- doxytag: member="KDirLister::infoMessage" ref="a56d13724f06b70a13694b95360c2529e" args="(const QString &msg)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void KDirLister::infoMessage </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> & </td>
<td class="paramname"><em>msg</em></td><td>)</td>
<td><code> [signal]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Emitted to display information about running jobs. </p>
<p>Examples of message are "Resolving host", "Connecting to host...", etc. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">msg</td><td>the info message </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="a1ad8ceef2a17b05e49eebc20ffb49676"></a><!-- doxytag: member="KDirLister::isFinished" ref="a1ad8ceef2a17b05e49eebc20ffb49676" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool KDirLister::isFinished </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Returns true if no io operation is currently in progress. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>true if finished, false otherwise </dd></dl>
<p>Definition at line <a class="el" href="kdirlister_8cpp_source.html#l02035">2035</a> of file <a class="el" href="kdirlister_8cpp_source.html">kdirlister.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="a550fcff5e967f079ec81ea00421f8357"></a><!-- doxytag: member="KDirLister::items" ref="a550fcff5e967f079ec81ea00421f8357" args="(WhichItems which=FilteredItems) const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="qptrlist.html">KFileItemList</a> KDirLister::items </td>
<td>(</td>
<td class="paramtype"><a class="el" href="classKDirLister.html#acc57ea947dbdad050ae2dff2504b7417">WhichItems</a> </td>
<td class="paramname"><em>which</em> = <code>FilteredItems</code></td><td>)</td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Returns the items listed for the current <a class="el" href="classKDirLister.html#a2bc08feafe10112d92e7e025f3f24ff7" title="Returns the top level URL that is listed by this KDirLister.">url()</a>. </p>
<p>This method will NOT start listing a directory, you should only call this when receiving the finished() signal.</p>
<p>The items in the KFileItemList are references to the items used by <a class="el" href="classKDirLister.html" title="The dir lister deals with the kiojob used to list and update a directory and has signals for the user...">KDirLister</a>, so e.g. an item gets destroyed when the <a class="el" href="classKDirLister.html#a7da4dd595cf52875059acf2ebb8d6f0a" title="Signal an item to remove.">deleteItem()</a> signal is emitted.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">which</td><td>specifies whether the returned list will contain all entries or only the ones that passed the nameFilter(), mimeFilter(), etc. Note that the latter causes iteration over all the items, filtering them. If this is too slow for you, use the <a class="el" href="classKDirLister.html#a104efac5272478c3f8a0e17c4d2603e2" title="Signal new items.">newItems()</a> signal, sending out filtered items in chunks. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>the items listed for the current <a class="el" href="classKDirLister.html#a2bc08feafe10112d92e7e025f3f24ff7" title="Returns the top level URL that is listed by this KDirLister.">url()</a>. </dd></dl>
<dl class="since"><dt><b>Since:</b></dt><dd>3.1 </dd></dl>
<p>Definition at line <a class="el" href="kdirlister_8cpp_source.html#l02468">2468</a> of file <a class="el" href="kdirlister_8cpp_source.html">kdirlister.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="abf7f660cc84c80d38ecf39bd212b0e5c"></a><!-- doxytag: member="KDirLister::itemsFilteredByMime" ref="abf7f660cc84c80d38ecf39bd212b0e5c" args="(const KFileItemList &items)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void KDirLister::itemsFilteredByMime </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="qptrlist.html">KFileItemList</a> & </td>
<td class="paramname"><em>items</em></td><td>)</td>
<td><code> [signal]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Send a list of items filtered-out by mime-type. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">items</td><td>the list of filtered items </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="a00a23ba6e0d4c5a7d99afcc0798fc7ed"></a><!-- doxytag: member="KDirLister::itemsForDir" ref="a00a23ba6e0d4c5a7d99afcc0798fc7ed" args="(const KURL &dir, WhichItems which=FilteredItems) const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="qptrlist.html">KFileItemList</a> KDirLister::itemsForDir </td>
<td>(</td>
<td class="paramtype">const KURL & </td>
<td class="paramname"><em>dir</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="classKDirLister.html#acc57ea947dbdad050ae2dff2504b7417">WhichItems</a> </td>
<td class="paramname"><em>which</em> = <code>FilteredItems</code> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Returns the items listed for the given <code>dir</code>. </p>
<p>This method will NOT start listing <code>dir</code>, you should only call this when receiving the finished() signal.</p>
<p>The items in the KFileItemList are references to the items used by <a class="el" href="classKDirLister.html" title="The dir lister deals with the kiojob used to list and update a directory and has signals for the user...">KDirLister</a>, so e.g. an item gets destroyed when the <a class="el" href="classKDirLister.html#a7da4dd595cf52875059acf2ebb8d6f0a" title="Signal an item to remove.">deleteItem()</a> signal is emitted.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">dir</td><td>specifies the url for which the items should be returned. This is only useful if you use <a class="el" href="classKDirLister.html" title="The dir lister deals with the kiojob used to list and update a directory and has signals for the user...">KDirLister</a> with multiple URLs i.e. using bool keep = true in <a class="el" href="classKDirLister.html#a0da1c19a8d5d49aa0d95e4f036310aa9" title="Run the directory lister on the given url.">openURL()</a>. </td></tr>
<tr><td class="paramname">which</td><td>specifies whether the returned list will contain all entries or only the ones that passed the nameFilter, mimeFilter, etc. Note that the latter causes iteration over all the items, filtering them. If this is too slow for you, use the <a class="el" href="classKDirLister.html#a104efac5272478c3f8a0e17c4d2603e2" title="Signal new items.">newItems()</a> signal, sending out filtered items in chunks. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>the items listed for <code>dir</code>. </dd></dl>
<dl class="since"><dt><b>Since:</b></dt><dd>3.1 </dd></dl>
<p>Definition at line <a class="el" href="kdirlister_8cpp_source.html#l02473">2473</a> of file <a class="el" href="kdirlister_8cpp_source.html">kdirlister.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="a113ef9f1cfda144ea8c827212d5c5a6d"></a><!-- doxytag: member="KDirLister::mainWindow" ref="a113ef9f1cfda144ea8c827212d5c5a6d" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="qwidget.html">QWidget</a> * KDirLister::mainWindow </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Returns the main window associated with this object. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>the associated main window, or 0 if there is none </dd></dl>
<dl class="since"><dt><b>Since:</b></dt><dd>3.1 </dd></dl>
<p>Definition at line <a class="el" href="kdirlister_8cpp_source.html#l02463">2463</a> of file <a class="el" href="kdirlister_8cpp_source.html">kdirlister.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="a630cdb5a3982a34c52098de53216167e"></a><!-- doxytag: member="KDirLister::matchesFilter" ref="a630cdb5a3982a34c52098de53216167e" args="(const KFileItem *) const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool KDirLister::matchesFilter </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="classKFileItem.html">KFileItem</a> * </td>
<td class="paramname"><em>item</em></td><td>)</td>
<td> const<code> [protected, virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Called for every new item before emitting <a class="el" href="classKDirLister.html#a104efac5272478c3f8a0e17c4d2603e2" title="Signal new items.">newItems()</a>. </p>
<p>You may reimplement this method in a subclass to implement your own filtering. The default implementation filters out ".." and everything not matching the name filter(s) </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>true if the item is "ok". false if the item shall not be shown in a view, e.g. files not matching a pattern *.cpp ( <a class="el" href="classKFileItem.html#a634254ded940b344506a79093459ac8c" title="Checks whether the file is hidden.">KFileItem::isHidden()</a>) </dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="classKDirLister.html#a8d27452e10d439aa130ab87f24b459d5" title="Checks whether name matches a filter in the list of name filters.">matchesFilter</a> </dd>
<dd>
<a class="el" href="classKDirLister.html#a83e03aac346a9018b6c9f9ea0f1f8d1f" title="Set a name filter to only list items matching this name, e.g.">setNameFilter</a> </dd></dl>
<p>Definition at line <a class="el" href="kdirlister_8cpp_source.html#l02144">2144</a> of file <a class="el" href="kdirlister_8cpp_source.html">kdirlister.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="a8d27452e10d439aa130ab87f24b459d5"></a><!-- doxytag: member="KDirLister::matchesFilter" ref="a8d27452e10d439aa130ab87f24b459d5" args="(const QString &name) const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool KDirLister::matchesFilter </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> & </td>
<td class="paramname"><em>name</em></td><td>)</td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Checks whether <code>name</code> matches a filter in the list of name filters. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>true if <code>name</code> matches a filter in the list, otherwise false. </dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="classKDirLister.html#a83e03aac346a9018b6c9f9ea0f1f8d1f" title="Set a name filter to only list items matching this name, e.g.">setNameFilter</a> </dd></dl>
<p>Definition at line <a class="el" href="kdirlister_8cpp_source.html#l02132">2132</a> of file <a class="el" href="kdirlister_8cpp_source.html">kdirlister.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="adc94511267a6664728e9e98044ebce66"></a><!-- doxytag: member="KDirLister::matchesMimeFilter" ref="adc94511267a6664728e9e98044ebce66" args="(const KFileItem *) const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool KDirLister::matchesMimeFilter </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="classKFileItem.html">KFileItem</a> * </td>
<td class="paramname"><em>item</em></td><td>)</td>
<td> const<code> [protected, virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Called for every new item before emitting <a class="el" href="classKDirLister.html#a104efac5272478c3f8a0e17c4d2603e2" title="Signal new items.">newItems()</a>. </p>
<p>You may reimplement this method in a subclass to implement your own filtering. The default implementation filters out ".." and everything not matching the name filter(s) </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>true if the item is "ok". false if the item shall not be shown in a view, e.g. files not matching a pattern *.cpp ( <a class="el" href="classKFileItem.html#a634254ded940b344506a79093459ac8c" title="Checks whether the file is hidden.">KFileItem::isHidden()</a>) </dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="classKDirLister.html#a27ab680407efa259292a7fba55098f5b" title="Checks whether mime matches a filter in the list of mime types.">matchesMimeFilter</a> </dd>
<dd>
<a class="el" href="classKDirLister.html#a33faab3d8e542d26c47b42a56e969e6e" title="Set mime-based filter to only list items matching the given mimetypes.">setMimeFilter</a> </dd></dl>
<p>Definition at line <a class="el" href="kdirlister_8cpp_source.html#l02161">2161</a> of file <a class="el" href="kdirlister_8cpp_source.html">kdirlister.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="a27ab680407efa259292a7fba55098f5b"></a><!-- doxytag: member="KDirLister::matchesMimeFilter" ref="a27ab680407efa259292a7fba55098f5b" args="(const QString &mime) const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool KDirLister::matchesMimeFilter </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> & </td>
<td class="paramname"><em>mime</em></td><td>)</td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Checks whether <code>mime</code> matches a filter in the list of mime types. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">mime</td><td>the mimetype to find in the filter list. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>true if <code>name</code> matches a filter in the list, otherwise false. </dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="classKDirLister.html#a33faab3d8e542d26c47b42a56e969e6e" title="Set mime-based filter to only list items matching the given mimetypes.">setMimeFilter</a>. </dd></dl>
<p>Definition at line <a class="el" href="kdirlister_8cpp_source.html#l02137">2137</a> of file <a class="el" href="kdirlister_8cpp_source.html">kdirlister.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="a1d5e080c3acc5ccc8e9f69e5ef9ac165"></a><!-- doxytag: member="KDirLister::mimeFilters" ref="a1d5e080c3acc5ccc8e9f69e5ef9ac165" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">const <a class="elRef" href="qstringlist.html">QStringList</a> & KDirLister::mimeFilters </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Returns the list of mime based filters, as set via <a class="el" href="classKDirLister.html#a33faab3d8e542d26c47b42a56e969e6e" title="Set mime-based filter to only list items matching the given mimetypes.">setMimeFilter()</a>. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>the list of mime based filters. Empty, when no mime filter is set. </dd></dl>
<p>Definition at line <a class="el" href="kdirlister_8cpp_source.html#l02127">2127</a> of file <a class="el" href="kdirlister_8cpp_source.html">kdirlister.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="a30e6cecd5a769e169c29a65905014d83"></a><!-- doxytag: member="KDirLister::nameFilter" ref="a30e6cecd5a769e169c29a65905014d83" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">const <a class="elRef" href="qstring.html">QString</a>& KDirLister::nameFilter </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Returns the current name filter, as set via <a class="el" href="classKDirLister.html#a83e03aac346a9018b6c9f9ea0f1f8d1f" title="Set a name filter to only list items matching this name, e.g.">setNameFilter()</a> </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>the current name filter, can be QString::null if filtering is turned off </dd></dl>
</div>
</div>
<a class="anchor" id="a104efac5272478c3f8a0e17c4d2603e2"></a><!-- doxytag: member="KDirLister::newItems" ref="a104efac5272478c3f8a0e17c4d2603e2" args="(const KFileItemList &items)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void KDirLister::newItems </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="qptrlist.html">KFileItemList</a> & </td>
<td class="paramname"><em>items</em></td><td>)</td>
<td><code> [signal]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Signal new items. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">items</td><td>a list of new items </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="a0da1c19a8d5d49aa0d95e4f036310aa9"></a><!-- doxytag: member="KDirLister::openURL" ref="a0da1c19a8d5d49aa0d95e4f036310aa9" args="(const KURL &_url, bool _keep=false, bool _reload=false)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool KDirLister::openURL </td>
<td>(</td>
<td class="paramtype">const KURL & </td>
<td class="paramname"><em>_url</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">bool </td>
<td class="paramname"><em>_keep</em> = <code>false</code>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">bool </td>
<td class="paramname"><em>_reload</em> = <code>false</code> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td><code> [virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Run the directory lister on the given url. </p>
<p>This method causes <a class="el" href="classKDirLister.html" title="The dir lister deals with the kiojob used to list and update a directory and has signals for the user...">KDirLister</a> to emit _all_ the items of <code>_url</code>, in any case. Depending on <code>_keep</code> either <a class="el" href="classKDirLister.html#a97dbbb27f096eace54f66aca71c71712" title="Signal to clear all items.">clear()</a> or <a class="el" href="classKDirLister.html#ae81822165915ff58f455e7f484502c94" title="Signal to empty the directory _url.">clear(const KURL &)</a> will be emitted first.</p>
<p>The <a class="el" href="classKDirLister.html#a104efac5272478c3f8a0e17c4d2603e2" title="Signal new items.">newItems()</a> signal may be emitted more than once to supply you with KFileItems, up until the signal <a class="el" href="classKDirLister.html#a6f3e769b242066ad4fd00493ae5b11f9" title="Tell the view that listing is finished.">completed()</a> is emitted (and <a class="el" href="classKDirLister.html#a1ad8ceef2a17b05e49eebc20ffb49676" title="Returns true if no io operation is currently in progress.">isFinished()</a> returns true).</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">_url</td><td>the directory URL. </td></tr>
<tr><td class="paramname">_keep</td><td>if true the previous directories aren't forgotten (they are still watched by kdirwatch and their items are kept for this <a class="el" href="classKDirLister.html" title="The dir lister deals with the kiojob used to list and update a directory and has signals for the user...">KDirLister</a>). This is useful for e.g. a treeview. </td></tr>
<tr><td class="paramname">_reload</td><td>indicates wether to use the cache (false) or to reread the directory from the disk. Use only when opening a dir not yet listed by this lister without using the cache. Otherwise use updateDirectory. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>true if successful, false otherwise (e.g. invalid <code>_url</code>) </dd></dl>
<p>Definition at line <a class="el" href="kdirlister_8cpp_source.html#l01852">1852</a> of file <a class="el" href="kdirlister_8cpp_source.html">kdirlister.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="ad6d72cadd198ba5fe511a1157b807f81"></a><!-- doxytag: member="KDirLister::percent" ref="ad6d72cadd198ba5fe511a1157b807f81" args="(int percent)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void KDirLister::percent </td>
<td>(</td>
<td class="paramtype">int </td>
<td class="paramname"><em>percent</em></td><td>)</td>
<td><code> [signal]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Progress signal showing the overall progress of the <a class="el" href="classKDirLister.html" title="The dir lister deals with the kiojob used to list and update a directory and has signals for the user...">KDirLister</a>. </p>
<p>This allows using a progress bar very easily. (see KProgress) </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">percent</td><td>the progress in percent </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="a89c3b02de4bedc4be40ba67770b7d742"></a><!-- doxytag: member="KDirLister::processedSize" ref="a89c3b02de4bedc4be40ba67770b7d742" args="(KIO::filesize_t size)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void KDirLister::processedSize </td>
<td>(</td>
<td class="paramtype"><a class="el" href="namespaceKIO.html#a90b418366ba9052c97d4dca845026f43">KIO::filesize_t</a> </td>
<td class="paramname"><em>size</em></td><td>)</td>
<td><code> [signal]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Regularly emitted to show the progress of this <a class="el" href="classKDirLister.html" title="The dir lister deals with the kiojob used to list and update a directory and has signals for the user...">KDirLister</a>. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">size</td><td>the processed size in bytes </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="ac17abdd2a3849f8d0c21b3f41bc4f9f2"></a><!-- doxytag: member="KDirLister::redirection" ref="ac17abdd2a3849f8d0c21b3f41bc4f9f2" args="(const KURL &oldUrl, const KURL &newUrl)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void KDirLister::redirection </td>
<td>(</td>
<td class="paramtype">const KURL & </td>
<td class="paramname"><em>oldUrl</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const KURL & </td>
<td class="paramname"><em>newUrl</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td><code> [signal]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Signal a redirection. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">oldUrl</td><td>the original URL </td></tr>
<tr><td class="paramname">newUrl</td><td>the new URL </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="aef3eb22d2967600b21407d76a88abce0"></a><!-- doxytag: member="KDirLister::redirection" ref="aef3eb22d2967600b21407d76a88abce0" args="(const KURL &_url)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void KDirLister::redirection </td>
<td>(</td>
<td class="paramtype">const KURL & </td>
<td class="paramname"><em>_url</em></td><td>)</td>
<td><code> [signal]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Signal a redirection. </p>
<p>Only emitted if there's just one directory to list, i.e. most probably <a class="el" href="classKDirLister.html#a0da1c19a8d5d49aa0d95e4f036310aa9" title="Run the directory lister on the given url.">openURL()</a> has been called with <code>_keep</code> == <code>false</code>. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">_url</td><td>the new URL </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="a8e34d037df6e0c8ed593dc50c5fa3699"></a><!-- doxytag: member="KDirLister::refreshItems" ref="a8e34d037df6e0c8ed593dc50c5fa3699" args="(const KFileItemList &items)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void KDirLister::refreshItems </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="qptrlist.html">KFileItemList</a> & </td>
<td class="paramname"><em>items</em></td><td>)</td>
<td><code> [signal]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Signal an item to refresh (its mimetype/icon/name has changed). </p>
<p>Note: <a class="el" href="classKFileItem.html#afcd50458f3068076a1101c5b6a3b140a" title="Throw away and re-read (for local files) all information about the file.">KFileItem::refresh</a> has already been called on those items. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">items</td><td>the items to refresh </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="a3fe843e980a7fba8ebee81182d096ae1"></a><!-- doxytag: member="KDirLister::rootItem" ref="a3fe843e980a7fba8ebee81182d096ae1" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classKFileItem.html">KFileItem</a> * KDirLister::rootItem </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Returns the file item of the URL. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>the file item for <a class="el" href="classKDirLister.html#a2bc08feafe10112d92e7e025f3f24ff7" title="Returns the top level URL that is listed by this KDirLister.">url()</a> itself (".") </dd></dl>
<p>Definition at line <a class="el" href="kdirlister_8cpp_source.html#l02040">2040</a> of file <a class="el" href="kdirlister_8cpp_source.html">kdirlister.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="a818588f30d84bd8751dbf3af1c88182d"></a><!-- doxytag: member="KDirLister::setAutoErrorHandlingEnabled" ref="a818588f30d84bd8751dbf3af1c88182d" args="(bool enable, QWidget *parent)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void KDirLister::setAutoErrorHandlingEnabled </td>
<td>(</td>
<td class="paramtype">bool </td>
<td class="paramname"><em>enable</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="elRef" href="qwidget.html">QWidget</a> * </td>
<td class="paramname"><em>parent</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Enable or disable auto error handling is enabled. </p>
<p>If enabled, it will show an error dialog to the user when an error occurs. It is turned on by default. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">enable</td><td>true to enable auto error handling, false to disable </td></tr>
<tr><td class="paramname">parent</td><td>the parent widget for the error dialogs, can be 0 for top-level </td></tr>
</table>
</dd>
</dl>
<dl class="see"><dt><b>See also:</b></dt><dd>autoErrorHandlingEnabled() </dd></dl>
<p>Definition at line <a class="el" href="kdirlister_8cpp_source.html#l01925">1925</a> of file <a class="el" href="kdirlister_8cpp_source.html">kdirlister.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="abe7cc2e18929b3d357a045de9665f9e8"></a><!-- doxytag: member="KDirLister::setAutoUpdate" ref="abe7cc2e18929b3d357a045de9665f9e8" args="(bool enable)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void KDirLister::setAutoUpdate </td>
<td>(</td>
<td class="paramtype">bool </td>
<td class="paramname"><em>enable</em></td><td>)</td>
<td><code> [virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Enable/disable automatic directory updating, when a directory changes (using <a class="el" href="classKDirWatch.html" title="Watch directories and files for changes.">KDirWatch</a>). </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">enable</td><td>true to enable, false to disable </td></tr>
</table>
</dd>
</dl>
<p>Definition at line <a class="el" href="kdirlister_8cpp_source.html#l01883">1883</a> of file <a class="el" href="kdirlister_8cpp_source.html">kdirlister.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="a6589dc9c9f2e40daf3344d5b39c8eda0"></a><!-- doxytag: member="KDirLister::setDirOnlyMode" ref="a6589dc9c9f2e40daf3344d5b39c8eda0" args="(bool dirsOnly)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void KDirLister::setDirOnlyMode </td>
<td>(</td>
<td class="paramtype">bool </td>
<td class="paramname"><em>dirsOnly</em></td><td>)</td>
<td><code> [virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Call this to list only directories. </p>
<p>By default this option is disabled (all files will be shown). </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">dirsOnly</td><td>true to list only directories </td></tr>
</table>
</dd>
</dl>
<p>Definition at line <a class="el" href="kdirlister_8cpp_source.html#l01911">1911</a> of file <a class="el" href="kdirlister_8cpp_source.html">kdirlister.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="a246a31e6b1d6c3bcaa2bdcf36d44d180"></a><!-- doxytag: member="KDirLister::setMainWindow" ref="a246a31e6b1d6c3bcaa2bdcf36d44d180" args="(QWidget *window)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void KDirLister::setMainWindow </td>
<td>(</td>
<td class="paramtype"><a class="elRef" href="qwidget.html">QWidget</a> * </td>
<td class="paramname"><em>window</em></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Pass the main window this object is associated with this is used for caching authentication data. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">window</td><td>the window to associate with, 0 to disassociate </td></tr>
</table>
</dd>
</dl>
<dl class="since"><dt><b>Since:</b></dt><dd>3.1 </dd></dl>
<p>Definition at line <a class="el" href="kdirlister_8cpp_source.html#l02458">2458</a> of file <a class="el" href="kdirlister_8cpp_source.html">kdirlister.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="a8c08401869f4a852cb631c70c90e6ac3"></a><!-- doxytag: member="KDirLister::setMimeExcludeFilter" ref="a8c08401869f4a852cb631c70c90e6ac3" args="(const QStringList &mimeList)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void KDirLister::setMimeExcludeFilter </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="qstringlist.html">QStringList</a> & </td>
<td class="paramname"><em>mimeList</em></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Filtering should be done with <a class="el" href="classKFileFilter.html" title="A KFileFilter is a simple base class for file filters.">KFileFilter</a>. </p>
<p>This will be implemented in a later revision of <a class="el" href="classKDirLister.html" title="The dir lister deals with the kiojob used to list and update a directory and has signals for the user...">KDirLister</a>. This method may be removed then.</p>
<p>Set mime-based exclude filter to only list items not matching the given mimetypes</p>
<p>NOTE: setting the filter does not automatically reload direcory. Also calling this function will not affect any named filter already set.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">mimeList</td><td>a list of mime-types. </td></tr>
</table>
</dd>
</dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="classKDirLister.html#a54def76e01106f37064c25fe00604386" title="Clears the mime based filter.">clearMimeFilter</a> </dd>
<dd>
<a class="el" href="classKDirLister.html#a27ab680407efa259292a7fba55098f5b" title="Checks whether mime matches a filter in the list of mime types.">matchesMimeFilter</a> </dd></dl>
<dl class="since"><dt><b>Since:</b></dt><dd>3.1 </dd></dl>
<p>Definition at line <a class="el" href="kdirlister_8cpp_source.html#l02105">2105</a> of file <a class="el" href="kdirlister_8cpp_source.html">kdirlister.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="a33faab3d8e542d26c47b42a56e969e6e"></a><!-- doxytag: member="KDirLister::setMimeFilter" ref="a33faab3d8e542d26c47b42a56e969e6e" args="(const QStringList &mimeList)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void KDirLister::setMimeFilter </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="qstringlist.html">QStringList</a> & </td>
<td class="paramname"><em>mimeList</em></td><td>)</td>
<td><code> [virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Set mime-based filter to only list items matching the given mimetypes. </p>
<p>NOTE: setting the filter does not automatically reload direcory. Also calling this function will not affect any named filter already set.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">mimeList</td><td>a list of mime-types.</td></tr>
</table>
</dd>
</dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="classKDirLister.html#a54def76e01106f37064c25fe00604386" title="Clears the mime based filter.">clearMimeFilter</a> </dd>
<dd>
<a class="el" href="classKDirLister.html#a27ab680407efa259292a7fba55098f5b" title="Checks whether mime matches a filter in the list of mime types.">matchesMimeFilter</a> </dd></dl>
<p>Definition at line <a class="el" href="kdirlister_8cpp_source.html#l02091">2091</a> of file <a class="el" href="kdirlister_8cpp_source.html">kdirlister.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="a83e03aac346a9018b6c9f9ea0f1f8d1f"></a><!-- doxytag: member="KDirLister::setNameFilter" ref="a83e03aac346a9018b6c9f9ea0f1f8d1f" args="(const QString &filter)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void KDirLister::setNameFilter </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> & </td>
<td class="paramname"><em>filter</em></td><td>)</td>
<td><code> [virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Set a name filter to only list items matching this name, e.g. </p>
<p>"*.cpp".</p>
<p>You can set more than one filter by separating them with whitespace, e.g "*.cpp *.h". Note: the direcory is not automatically reloaded.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">filter</td><td>the new filter, QString::null to disable filtering </td></tr>
</table>
</dd>
</dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="classKDirLister.html#a8d27452e10d439aa130ab87f24b459d5" title="Checks whether name matches a filter in the list of name filters.">matchesFilter</a> </dd></dl>
<p>Definition at line <a class="el" href="kdirlister_8cpp_source.html#l02065">2065</a> of file <a class="el" href="kdirlister_8cpp_source.html">kdirlister.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="ab3ec5ca80a8994a3f66addc25b43b5b2"></a><!-- doxytag: member="KDirLister::setShowingDotFiles" ref="ab3ec5ca80a8994a3f66addc25b43b5b2" args="(bool _showDotFiles)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void KDirLister::setShowingDotFiles </td>
<td>(</td>
<td class="paramtype">bool </td>
<td class="paramname"><em>_showDotFiles</em></td><td>)</td>
<td><code> [virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Changes the "is viewing dot files" setting. </p>
<p>Calls <a class="el" href="classKDirLister.html#aa3d94820e6e4b25c6bf1a3b01a959f5d" title="Update the directory _dir.">updateDirectory()</a> if setting changed. By default this option is disabled (hidden files will not be shown). </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">_showDotFiles</td><td>true to enable showing hidden files, false to disable </td></tr>
</table>
</dd>
</dl>
<dl class="see"><dt><b>See also:</b></dt><dd>showingDotFiles() </dd></dl>
<p>Definition at line <a class="el" href="kdirlister_8cpp_source.html#l01897">1897</a> of file <a class="el" href="kdirlister_8cpp_source.html">kdirlister.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="a93994daf20757a1bdb639869310f9eda"></a><!-- doxytag: member="KDirLister::showingDotFiles" ref="a93994daf20757a1bdb639869310f9eda" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool KDirLister::showingDotFiles </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Checks whether hidden files (files beginning with a dot) will be shown. </p>
<p>By default this option is disabled (hidden files will be not shown). </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>true if dot files are shown, false otherwise </dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="classKDirLister.html#ab3ec5ca80a8994a3f66addc25b43b5b2" title="Changes the "is viewing dot files" setting.">setShowingDotFiles()</a> </dd></dl>
</div>
</div>
<a class="anchor" id="a16639c0ca11242d3f58a9c4451d8b317"></a><!-- doxytag: member="KDirLister::speed" ref="a16639c0ca11242d3f58a9c4451d8b317" args="(int bytes_per_second)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void KDirLister::speed </td>
<td>(</td>
<td class="paramtype">int </td>
<td class="paramname"><em>bytes_per_second</em></td><td>)</td>
<td><code> [signal]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Emitted to display information about the speed of the jobs. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">bytes_per_second</td><td>the speed in bytes/s </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="aae4ffaa085ea8b729b1bf5faa2b831af"></a><!-- doxytag: member="KDirLister::started" ref="aae4ffaa085ea8b729b1bf5faa2b831af" args="(const KURL &_url)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void KDirLister::started </td>
<td>(</td>
<td class="paramtype">const KURL & </td>
<td class="paramname"><em>_url</em></td><td>)</td>
<td><code> [signal]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Tell the view that we started to list <code>_url</code>. </p>
<p>NOTE: this does _not_ imply that there is really a job running! I.e. KDirLister::jobs() may return an empty list. In this case the items are taken from the cache.</p>
<p>The view knows that openURL should start it, so it might seem useless, but the view also needs to know when an automatic update happens. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">_url</td><td>the URL to list </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="a1143f8f50647ae8db68396128b04c44e"></a><!-- doxytag: member="KDirLister::stop" ref="a1143f8f50647ae8db68396128b04c44e" args="(const KURL &_url)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void KDirLister::stop </td>
<td>(</td>
<td class="paramtype">const KURL & </td>
<td class="paramname"><em>_url</em></td><td>)</td>
<td><code> [virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Stop listing the given directory. </p>
<p>Emits <a class="el" href="classKDirLister.html#a645cccfa087d9d2917aaf4d1903d694d" title="Tell the view that the user canceled the listing.">canceled()</a> if the killed job was the last running one. Emits <a class="el" href="classKDirLister.html#a8876095a5f477606a479fd44037a6d39" title="Tell the view that the listing of the directory _url was canceled.">canceled( const KURL& )</a> for the killed job if there are at least two directories being watched by <a class="el" href="classKDirLister.html" title="The dir lister deals with the kiojob used to list and update a directory and has signals for the user...">KDirLister</a>. No signal is emitted if there was no job running for <code>_url</code>. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">_url</td><td>the directory URL </td></tr>
</table>
</dd>
</dl>
<p>Definition at line <a class="el" href="kdirlister_8cpp_source.html#l01872">1872</a> of file <a class="el" href="kdirlister_8cpp_source.html">kdirlister.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="a900b66e2f5f96b59ec09b1327bb0e903"></a><!-- doxytag: member="KDirLister::stop" ref="a900b66e2f5f96b59ec09b1327bb0e903" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void KDirLister::stop </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td><code> [virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Stop listing all directories currently being listed. </p>
<p>Emits <a class="el" href="classKDirLister.html#a645cccfa087d9d2917aaf4d1903d694d" title="Tell the view that the user canceled the listing.">canceled()</a> if there was at least one job running. Emits <a class="el" href="classKDirLister.html#a8876095a5f477606a479fd44037a6d39" title="Tell the view that the listing of the directory _url was canceled.">canceled( const KURL& )</a> for each stopped job if there are at least two dirctories being watched by <a class="el" href="classKDirLister.html" title="The dir lister deals with the kiojob used to list and update a directory and has signals for the user...">KDirLister</a>. </p>
<p>Definition at line <a class="el" href="kdirlister_8cpp_source.html#l01866">1866</a> of file <a class="el" href="kdirlister_8cpp_source.html">kdirlister.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="a584ab2bf1ed098a5f773a46928e65b1d"></a><!-- doxytag: member="KDirLister::totalSize" ref="a584ab2bf1ed098a5f773a46928e65b1d" args="(KIO::filesize_t size)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void KDirLister::totalSize </td>
<td>(</td>
<td class="paramtype"><a class="el" href="namespaceKIO.html#a90b418366ba9052c97d4dca845026f43">KIO::filesize_t</a> </td>
<td class="paramname"><em>size</em></td><td>)</td>
<td><code> [signal]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Emitted when we know the size of the jobs. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">size</td><td>the total size in bytes </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="aa3d94820e6e4b25c6bf1a3b01a959f5d"></a><!-- doxytag: member="KDirLister::updateDirectory" ref="aa3d94820e6e4b25c6bf1a3b01a959f5d" args="(const KURL &_dir)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void KDirLister::updateDirectory </td>
<td>(</td>
<td class="paramtype">const KURL & </td>
<td class="paramname"><em>_dir</em></td><td>)</td>
<td><code> [virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Update the directory <code>_dir</code>. </p>
<p>This method causes <a class="el" href="classKDirLister.html" title="The dir lister deals with the kiojob used to list and update a directory and has signals for the user...">KDirLister</a> to _only_ emit the items of <code>_dir</code> that actually changed compared to the current state in the cache and updates the cache.</p>
<p>The current implementation calls updateDirectory automatically for local files, using <a class="el" href="classKDirWatch.html" title="Watch directories and files for changes.">KDirWatch</a> (if autoUpdate() is true), but it might be useful to force an update manually.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">_dir</td><td>the directory URL </td></tr>
</table>
</dd>
</dl>
<p>Definition at line <a class="el" href="kdirlister_8cpp_source.html#l02030">2030</a> of file <a class="el" href="kdirlister_8cpp_source.html">kdirlister.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="a2bc08feafe10112d92e7e025f3f24ff7"></a><!-- doxytag: member="KDirLister::url" ref="a2bc08feafe10112d92e7e025f3f24ff7" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">const KURL & KDirLister::url </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Returns the top level URL that is listed by this <a class="el" href="classKDirLister.html" title="The dir lister deals with the kiojob used to list and update a directory and has signals for the user...">KDirLister</a>. </p>
<p>It might be different from the one given with <a class="el" href="classKDirLister.html#a0da1c19a8d5d49aa0d95e4f036310aa9" title="Run the directory lister on the given url.">openURL()</a> if there was a redirection. If you called <a class="el" href="classKDirLister.html#a0da1c19a8d5d49aa0d95e4f036310aa9" title="Run the directory lister on the given url.">openURL()</a> with <code>_keep</code> == true this is the first url opened (e.g. in a treeview this is the root).</p>
<dl class="return"><dt><b>Returns:</b></dt><dd>the url used by this instance to list the files. </dd></dl>
<p>Definition at line <a class="el" href="kdirlister_8cpp_source.html#l01931">1931</a> of file <a class="el" href="kdirlister_8cpp_source.html">kdirlister.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="a67fa9acc51963f71515bf5106cdff8e2"></a><!-- doxytag: member="KDirLister::validURL" ref="a67fa9acc51963f71515bf5106cdff8e2" args="(const KURL &) const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool KDirLister::validURL </td>
<td>(</td>
<td class="paramtype">const KURL & </td>
<td class="paramname"><em>_url</em></td><td>)</td>
<td> const<code> [protected, virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Checks if an url is malformed or not and displays an error message if it is and autoErrorHandling is set to true. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>true if url is valid, otherwise false. </dd></dl>
<p>Definition at line <a class="el" href="kdirlister_8cpp_source.html#l02210">2210</a> of file <a class="el" href="kdirlister_8cpp_source.html">kdirlister.cpp</a>.</p>
</div>
</div>
<hr/>The documentation for this class was generated from the following files:<ul>
<li><a class="el" href="kdirlister_8h_source.html">kdirlister.h</a></li>
<li><a class="el" href="kdirlister_8cpp_source.html">kdirlister.cpp</a></li>
</ul>
</div>
</div></div>
</td>
</tr>
<tr>
<td valign="top" id="leftmenu" width="25%">
<a name="navigation"></a>
<div class="menu_box"><h2>kio/kio</h2>
<div class="nav_list">
<ul><li><a href="index.html">Main Page</a></li><li><a href="modules.html">Modules</a></li><li><a href="namespaces.html">Namespace List</a></li><li><a href="hierarchy.html">Class Hierarchy</a></li><li><a href="classes.html">Alphabetical List</a></li><li><a href="annotated.html">Class List</a></li><li><a href="files.html">File List</a></li><li><a href="namespacemembers.html">Namespace Members</a></li><li><a href="functions.html">Class Members</a></li><li><a href="pages.html">Related Pages</a></li></ul>
<!--
<h2>Class Picker</h2>
<div style="text-align: center;">
<form name="guideform">
<select name="guidelinks" style="width:100%;" onChange="window.location=document.guideform.guidelinks.options[document.guideform.guidelinks.selectedIndex].value">
<option value="annotated.html">-- Choose --</option>
<option value="classKACL.html">kacl</option>, <option value="classKAr.html">kar</option>, <option value="classKArchive.html">karchive</option>, <option value="classKArchiveDirectory.html">karchivedirectory</option>, <option value="classKArchiveEntry.html">karchiveentry</option>, <option value="classKArchiveFile.html">karchivefile</option>, <option value="classKAutoMount.html">kautomount</option>, <option value="classKAutoUnmount.html">kautounmount</option>, <option value="classKDataTool.html">kdatatool</option>, <option value="classKDataToolAction.html">kdatatoolaction</option>, <option value="classKDataToolInfo.html">kdatatoolinfo</option>, <option value="classKDCOPServiceStarter.html">kdcopservicestarter</option>, <option value="classKDEDesktopMimeType.html">kdedesktopmimetype</option>, <option value="classKDirLister.html">kdirlister</option>, <option value="classKDirNotify.html">kdirnotify</option>, <option value="classKDirWatch.html">kdirwatch</option>, <option value="classKEMailSettings.html">kemailsettings</option>, <option value="classKExecMimeType.html">kexecmimetype</option>, <option value="classKFileFilter.html">kfilefilter</option>, <option value="classKFileItem.html">kfileitem</option>, <option value="classKFileMetaInfo.html">kfilemetainfo</option>, <option value="classKFileMetaInfoGroup.html">kfilemetainfogroup</option>, <option value="classKFileMetaInfoItem.html">kfilemetainfoitem</option>, <option value="classKFileMimeTypeInfo.html">kfilemimetypeinfo</option>, <option value="classKFileMimeTypeInfo_1_1GroupInfo.html">kfilemimetypeinfo::groupinfo</option>, <option value="classKFileMimeTypeInfo_1_1ItemInfo.html">kfilemimetypeinfo::iteminfo</option>, <option value="classKFilePlugin.html">kfileplugin</option>, <option value="classKFileShare.html">kfileshare</option>, <option value="classKFilterBase.html">kfilterbase</option>, <option value="classKFilterDev.html">kfilterdev</option>, <option value="classKFolderType.html">kfoldertype</option>, <option value="classKImageIO.html">kimageio</option>, <option value="classKIO_1_1AuthInfo.html">kio::authinfo</option>, <option value="classKIO_1_1ChmodJob.html">kio::chmodjob</option>, <option value="classKIO_1_1Connection.html">kio::connection</option>, <option value="classKIO_1_1CopyJob.html">kio::copyjob</option>, <option value="classKIO_1_1DataProtocol.html">kio::dataprotocol</option>, <option value="classKIO_1_1DataSlave.html">kio::dataslave</option>, <option value="classKIO_1_1DavJob.html">kio::davjob</option>, <option value="classKIO_1_1DeleteJob.html">kio::deletejob</option>, <option value="classKIO_1_1FileCopyJob.html">kio::filecopyjob</option>, <option value="classKIO_1_1ForwardingSlaveBase.html">kio::forwardingslavebase</option>, <option value="classKIO_1_1Job.html">kio::job</option>, <option value="classKIO_1_1ListJob.html">kio::listjob</option>, <option value="classKIO_1_1MetaData.html">kio::metadata</option>, <option value="classKIO_1_1MetaInfoJob.html">kio::metainfojob</option>, <option value="classKIO_1_1MimetypeJob.html">kio::mimetypejob</option>, <option value="classKIO_1_1MkdirJob.html">kio::mkdirjob</option>, <option value="classKIO_1_1MultiGetJob.html">kio::multigetjob</option>, <option value="classKIO_1_1NetAccess.html">kio::netaccess</option>, <option value="classKIO_1_1NetRC.html">kio::netrc</option>, <option value="classKIO_1_1PasswordDialog.html">kio::passworddialog</option>, <option value="classKIO_1_1PreviewJob.html">kio::previewjob</option>, <option value="classKIO_1_1ProgressBase.html">kio::progressbase</option>, <option value="classKIO_1_1RenameDlg.html">kio::renamedlg</option>, <option value="classKIO_1_1Scheduler.html">kio::scheduler</option>, <option value="classKIO_1_1SimpleJob.html">kio::simplejob</option>, <option value="classKIO_1_1Slave.html">kio::slave</option>, <option value="classKIO_1_1SlaveBase.html">kio::slavebase</option>, <option value="classKIO_1_1SlaveConfig.html">kio::slaveconfig</option>, <option value="classKIO_1_1SlaveInterface.html">kio::slaveinterface</option>, <option value="classKIO_1_1StatJob.html">kio::statjob</option>, <option value="classKIO_1_1StatusbarProgress.html">kio::statusbarprogress</option>, <option value="classKIO_1_1StoredTransferJob.html">kio::storedtransferjob</option>, <option value="classKIO_1_1TCPSlaveBase.html">kio::tcpslavebase</option>, <option value="classKIO_1_1TransferJob.html">kio::transferjob</option>, <option value="classKLimitedIODevice.html">klimitediodevice</option>, <option value="classKMimeMagic.html">kmimemagic</option>, <option value="classKMimeMagicResult.html">kmimemagicresult</option>, <option value="classKMimeType.html">kmimetype</option>, <option value="classKMimeTypeChooser.html">kmimetypechooser</option>, <option value="classKMimeTypeChooserDialog.html">kmimetypechooserdialog</option>, <option value="classKMimeTypeResolver.html">kmimetyperesolver</option>, <option value="classKNFSShare.html">knfsshare</option>, <option value="classKOCRDialog.html">kocrdialog</option>, <option value="classKOCRDialogFactory.html">kocrdialogfactory</option>, <option value="classKOpenWithHandler.html">kopenwithhandler</option>, <option value="classKProtocolInfo.html">kprotocolinfo</option>, <option value="classKProtocolManager.html">kprotocolmanager</option>, <option value="classKRemoteEncoding.html">kremoteencoding</option>, <option value="classKRun.html">krun</option>, <option value="classKSambaShare.html">ksambashare</option>, <option value="classKScanDialog.html">kscandialog</option>, <option value="classKScanDialogFactory.html">kscandialogfactory</option>, <option value="classKService.html">kservice</option>, <option value="classKServiceGroup.html">kservicegroup</option>, <option value="classKServiceOffer.html">kserviceoffer</option>, <option value="classKServiceType.html">kservicetype</option>, <option value="classKServiceTypeProfile.html">kservicetypeprofile</option>, <option value="classKShellCompletion.html">kshellcompletion</option>, <option value="classKShred.html">kshred</option>, <option value="classKSimpleFileFilter.html">ksimplefilefilter</option>, <option value="classKTar.html">ktar</option>, <option value="classKTrader.html">ktrader</option>, <option value="classKURIFilter.html">kurifilter</option>, <option value="classKURIFilterData.html">kurifilterdata</option>, <option value="classKURIFilterPlugin.html">kurifilterplugin</option>, <option value="classKURIFilterPluginList.html">kurifilterpluginlist</option>, <option value="classKURLCompletion.html">kurlcompletion</option>, <option value="classKURLPixmapProvider.html">kurlpixmapprovider</option>, <option value="classKZip.html">kzip</option>, <option value="classObserver.html">observer</option>, <option value="classRenameDlgPlugin.html">renamedlgplugin</option>, <option value="classThumbCreator.html">thumbcreator</option>,
</select>
</form>
</div>
-->
</div></div>
<div class="menu_box"><h2>API Dox</h2>
<div class="nav_list">
<ul>
<li><a href="../../../arts/html/index.html">arts</a></li><li><a href="../../../dcop/html/index.html">dcop</a></li><li><a href="../../../dnssd/html/index.html">dnssd</a></li><li><a href="../../../interfaces/html/index.html">interfaces</a></li><li> <a href="../../../interfaces/kimproxy/interface/html/index.html">interface</a></li><li> <a href="../../../interfaces/kimproxy/library/html/index.html">library</a></li><li> <a href="../../../interfaces/kspeech/html/index.html">kspeech</a></li><li> <a href="../../../interfaces/ktexteditor/html/index.html">ktexteditor</a></li><li><a href="../../../kabc/html/index.html">kabc</a></li><li><a href="../../../kate/html/index.html">kate</a></li><li><a href="../../../kcmshell/html/index.html">kcmshell</a></li><li><a href="../../../kdecore/html/index.html">kdecore</a></li><li><a href="../../../kded/html/index.html">kded</a></li><li><a href="../../../kdefx/html/index.html">kdefx</a></li><li><a href="../../../kdeprint/html/index.html">kdeprint</a></li><li><a href="../../../kdesu/html/index.html">kdesu</a></li><li><a href="../../../kdeui/html/index.html">kdeui</a></li><li><a href="../../../kdoctools/html/index.html">kdoctools</a></li><li><a href="../../../khtml/html/index.html">khtml</a></li><li><a href="../../../kimgio/html/index.html">kimgio</a></li><li><a href="../../../kinit/html/index.html">kinit</a></li><li><a href="../../../kio/html/index.html">kio</a></li><li> <a href="../../../kio/bookmarks/html/index.html">bookmarks</a></li><li> <a href="../../../kio/httpfilter/html/index.html">httpfilter</a></li><li> <a href="../../../kio/kfile/html/index.html">kfile</a></li><li> <a href="../../../kio/kio/html/index.html">kio</a></li><li> <a href="../../../kio/kioexec/html/index.html">kioexec</a></li><li> <a href="../../../kio/kpasswdserver/html/index.html">kpasswdserver</a></li><li> <a href="../../../kio/kssl/html/index.html">kssl</a></li><li><a href="../../../kioslave/html/index.html">kioslave</a></li><li> <a href="../../../kioslave/http/html/index.html">http</a></li><li><a href="../../../kjs/html/index.html">kjs</a></li><li><a href="../../../kmdi/html/index.html">kmdi</a></li><li> <a href="../../../kmdi/kmdi/html/index.html">kmdi</a></li><li><a href="../../../knewstuff/html/index.html">knewstuff</a></li><li><a href="../../../kparts/html/index.html">kparts</a></li><li><a href="../../../kresources/html/index.html">kresources</a></li><li><a href="../../../kspell2/html/index.html">kspell2</a></li><li><a href="../../../kunittest/html/index.html">kunittest</a></li><li><a href="../../../kutils/html/index.html">kutils</a></li><li><a href="../../../kwallet/html/index.html">kwallet</a></li><li><a href="../../../libkmid/html/index.html">libkmid</a></li><li><a href="../../../libkscreensaver/html/index.html">libkscreensaver</a></li>
</ul></div></div>
</td>
</tr>
</table>
<span class="doNotDisplay">
<a href="http://www.kde.org/" accesskey="8">KDE Home</a> |
<a href="http://accessibility.kde.org/" accesskey="9">KDE Accessibility Home</a> |
<a href="http://www.kde.org/media/accesskeys.php" accesskey="0">Description of Access Keys</a>
</span>
<div style="height: 8px"></div>
<div id="footer">
<div id="footer_left">
Maintained by <a href="mailto:groot@kde.org">Adriaan de Groot</a>
and
<a href="mailto:winter@kde.org">Allen Winter</a>.
<br/>
KDE and K Desktop Environment are trademarks of <a href="http://www.kde.org/areas/kde-ev/" 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 id="footer_right"><img src="/media/images/footer_right.png" style="margin: 0px" alt="" /></div>
</div>
<!--
WARNING: DO NOT SEND MAIL TO THE FOLLOWING EMAIL ADDRESS! YOU WILL
BE BLOCKED INSTANTLY AND PERMANENTLY!
<a href="mailto:aaaatrap-425acc3b5374943f@kde.org">Block me</a>
WARNING END
-->
</body>
</html>
