<?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/kfile: krecentdirs.cpp Source File (kio/kfile)</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=".">kfile</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.5.5 --> <h1>krecentdirs.cpp</h1><div class="fragment"><pre class="fragment"><a name="l00001"></a>00001 <span class="comment">/* -*- c++ -*-</span> <a name="l00002"></a>00002 <span class="comment"> * Copyright (C)2000 Waldo Bastian <bastian@kde.org></span> <a name="l00003"></a>00003 <span class="comment"> *</span> <a name="l00004"></a>00004 <span class="comment"> * All rights reserved.</span> <a name="l00005"></a>00005 <span class="comment"> *</span> <a name="l00006"></a>00006 <span class="comment"> * Redistribution and use in source and binary forms, with or without</span> <a name="l00007"></a>00007 <span class="comment"> * modification, are permitted provided that the following conditions</span> <a name="l00008"></a>00008 <span class="comment"> * are met:</span> <a name="l00009"></a>00009 <span class="comment"> * 1. Redistributions of source code must retain the above copyright</span> <a name="l00010"></a>00010 <span class="comment"> * notice, this list of conditions and the following disclaimer.</span> <a name="l00011"></a>00011 <span class="comment"> * 2. Redistributions in binary form must reproduce the above copyright</span> <a name="l00012"></a>00012 <span class="comment"> * notice, this list of conditions and the following disclaimer in the</span> <a name="l00013"></a>00013 <span class="comment"> * documentation and/or other materials provided with the distribution.</span> <a name="l00014"></a>00014 <span class="comment"> *</span> <a name="l00015"></a>00015 <span class="comment"> * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND</span> <a name="l00016"></a>00016 <span class="comment"> * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE</span> <a name="l00017"></a>00017 <span class="comment"> * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE</span> <a name="l00018"></a>00018 <span class="comment"> * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE</span> <a name="l00019"></a>00019 <span class="comment"> * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL</span> <a name="l00020"></a>00020 <span class="comment"> * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS</span> <a name="l00021"></a>00021 <span class="comment"> * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)</span> <a name="l00022"></a>00022 <span class="comment"> * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT</span> <a name="l00023"></a>00023 <span class="comment"> * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY</span> <a name="l00024"></a>00024 <span class="comment"> * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF</span> <a name="l00025"></a>00025 <span class="comment"> * SUCH DAMAGE.</span> <a name="l00026"></a>00026 <span class="comment"> *</span> <a name="l00027"></a>00027 <span class="comment"> */</span> <a name="l00028"></a>00028 <span class="preprocessor">#include <krecentdirs.h></span> <a name="l00029"></a>00029 <span class="preprocessor">#include <ksimpleconfig.h></span> <a name="l00030"></a>00030 <span class="preprocessor">#include <kstandarddirs.h></span> <a name="l00031"></a>00031 <span class="preprocessor">#include <kglobalsettings.h></span> <a name="l00032"></a>00032 <a name="l00033"></a>00033 <span class="preprocessor">#define MAX_DIR_HISTORY 3</span> <a name="l00034"></a>00034 <span class="preprocessor"></span> <a name="l00035"></a>00035 <span class="keyword">static</span> <span class="keywordtype">void</span> recentdirs_done(KConfig *config) <a name="l00036"></a>00036 { <a name="l00037"></a>00037 <span class="keywordflow">if</span> (config == KGlobal::config()) <a name="l00038"></a>00038 { <a name="l00039"></a>00039 config->sync(); <a name="l00040"></a>00040 } <a name="l00041"></a>00041 <span class="keywordflow">else</span> <a name="l00042"></a>00042 { <a name="l00043"></a>00043 <span class="keyword">delete</span> config; <a name="l00044"></a>00044 } <a name="l00045"></a>00045 } <a name="l00046"></a>00046 <a name="l00047"></a>00047 <span class="keyword">static</span> KConfig *recentdirs_readList(<a class="codeRef" doxygen="qt.tag:/usr/lib/qt3/doc/html/" href="/usr/lib/qt3/doc/html/qstring.html">QString</a> &key, <a class="codeRef" doxygen="qt.tag:/usr/lib/qt3/doc/html/" href="/usr/lib/qt3/doc/html/qstringlist.html">QStringList</a> &result, <span class="keywordtype">bool</span> readOnly) <a name="l00048"></a>00048 { <a name="l00049"></a>00049 KConfig *config; <a name="l00050"></a>00050 <span class="keywordflow">if</span> ((key.<a class="codeRef" doxygen="qt.tag:/usr/lib/qt3/doc/html/" href="/usr/lib/qt3/doc/html/qstring.html#length">length</a>() < 2) || (key[0] != <span class="charliteral">':'</span>)) <a name="l00051"></a>00051 key = <span class="stringliteral">":default"</span>; <a name="l00052"></a>00052 <span class="keywordflow">if</span> (key[1] == <span class="charliteral">':'</span>) <a name="l00053"></a>00053 { <a name="l00054"></a>00054 key = key.<a class="codeRef" doxygen="qt.tag:/usr/lib/qt3/doc/html/" href="/usr/lib/qt3/doc/html/qstring.html#mid">mid</a>(2); <a name="l00055"></a>00055 config = <span class="keyword">new</span> KSimpleConfig(<a class="codeRef" doxygen="qt.tag:/usr/lib/qt3/doc/html/" href="/usr/lib/qt3/doc/html/qstring.html#fromLatin1">QString::fromLatin1</a>(<span class="stringliteral">"krecentdirsrc"</span>), readOnly); <a name="l00056"></a>00056 } <a name="l00057"></a>00057 <span class="keywordflow">else</span> <a name="l00058"></a>00058 { <a name="l00059"></a>00059 key = key.<a class="codeRef" doxygen="qt.tag:/usr/lib/qt3/doc/html/" href="/usr/lib/qt3/doc/html/qstring.html#mid">mid</a>(1); <a name="l00060"></a>00060 config = KGlobal::config(); <a name="l00061"></a>00061 config->setGroup(<a class="codeRef" doxygen="qt.tag:/usr/lib/qt3/doc/html/" href="/usr/lib/qt3/doc/html/qstring.html#fromLatin1">QString::fromLatin1</a>(<span class="stringliteral">"Recent Dirs"</span>)); <a name="l00062"></a>00062 } <a name="l00063"></a>00063 <a name="l00064"></a>00064 result=config->readPathListEntry(key); <a name="l00065"></a>00065 <span class="keywordflow">if</span> (result.isEmpty()) <a name="l00066"></a>00066 { <a name="l00067"></a>00067 result.append(KGlobalSettings::documentPath()); <a name="l00068"></a>00068 } <a name="l00069"></a>00069 <span class="keywordflow">return</span> config; <a name="l00070"></a>00070 } <a name="l00071"></a>00071 <a name="l00072"></a><a class="code" href="classKRecentDirs.html#7e8db981ca104542337405800188f0f4">00072</a> <a class="codeRef" doxygen="qt.tag:/usr/lib/qt3/doc/html/" href="/usr/lib/qt3/doc/html/qstringlist.html">QStringList</a> <a class="code" href="classKRecentDirs.html#7e8db981ca104542337405800188f0f4" title="Returns a list of directories associated with this file-class.">KRecentDirs::list</a>(<span class="keyword">const</span> <a class="codeRef" doxygen="qt.tag:/usr/lib/qt3/doc/html/" href="/usr/lib/qt3/doc/html/qstring.html">QString</a> &fileClass) <a name="l00073"></a>00073 { <a name="l00074"></a>00074 <a class="codeRef" doxygen="qt.tag:/usr/lib/qt3/doc/html/" href="/usr/lib/qt3/doc/html/qstring.html">QString</a> key = fileClass; <a name="l00075"></a>00075 <a class="codeRef" doxygen="qt.tag:/usr/lib/qt3/doc/html/" href="/usr/lib/qt3/doc/html/qstringlist.html">QStringList</a> result; <a name="l00076"></a>00076 recentdirs_done(recentdirs_readList(key, result, <span class="keyword">true</span>)); <a name="l00077"></a>00077 <span class="keywordflow">return</span> result; <a name="l00078"></a>00078 } <a name="l00079"></a>00079 <a name="l00080"></a><a class="code" href="classKRecentDirs.html#1d58a14171d3269ed2c82288b4ca9661">00080</a> <a class="codeRef" doxygen="qt.tag:/usr/lib/qt3/doc/html/" href="/usr/lib/qt3/doc/html/qstring.html">QString</a> <a class="code" href="classKRecentDirs.html#1d58a14171d3269ed2c82288b4ca9661" title="Returns the most recently used directory accociated with this file-class.">KRecentDirs::dir</a>(<span class="keyword">const</span> <a class="codeRef" doxygen="qt.tag:/usr/lib/qt3/doc/html/" href="/usr/lib/qt3/doc/html/qstring.html">QString</a> &fileClass) <a name="l00081"></a>00081 { <a name="l00082"></a>00082 <a class="codeRef" doxygen="qt.tag:/usr/lib/qt3/doc/html/" href="/usr/lib/qt3/doc/html/qstringlist.html">QStringList</a> result = <a class="code" href="classKRecentDirs.html#7e8db981ca104542337405800188f0f4" title="Returns a list of directories associated with this file-class.">list</a>(fileClass); <a name="l00083"></a>00083 <span class="keywordflow">return</span> result[0]; <a name="l00084"></a>00084 } <a name="l00085"></a>00085 <a name="l00086"></a><a class="code" href="classKRecentDirs.html#9c29070d100ba1617ddffb3b71fd815f">00086</a> <span class="keywordtype">void</span> <a class="code" href="classKRecentDirs.html#9c29070d100ba1617ddffb3b71fd815f" title="Associates directory with fileClass.">KRecentDirs::add</a>(<span class="keyword">const</span> <a class="codeRef" doxygen="qt.tag:/usr/lib/qt3/doc/html/" href="/usr/lib/qt3/doc/html/qstring.html">QString</a> &fileClass, <span class="keyword">const</span> <a class="codeRef" doxygen="qt.tag:/usr/lib/qt3/doc/html/" href="/usr/lib/qt3/doc/html/qstring.html">QString</a> &directory) <a name="l00087"></a>00087 { <a name="l00088"></a>00088 <a class="codeRef" doxygen="qt.tag:/usr/lib/qt3/doc/html/" href="/usr/lib/qt3/doc/html/qstring.html">QString</a> key = fileClass; <a name="l00089"></a>00089 <a class="codeRef" doxygen="qt.tag:/usr/lib/qt3/doc/html/" href="/usr/lib/qt3/doc/html/qstringlist.html">QStringList</a> result; <a name="l00090"></a>00090 KConfig *config = recentdirs_readList(key, result, <span class="keyword">false</span>); <a name="l00091"></a>00091 <span class="comment">// make sure the dir is first in history</span> <a name="l00092"></a>00092 result.remove(directory); <a name="l00093"></a>00093 result.prepend(directory); <a name="l00094"></a>00094 <span class="keywordflow">while</span>(result.count() > MAX_DIR_HISTORY) <a name="l00095"></a>00095 result.remove(result.fromLast()); <a name="l00096"></a>00096 config->writePathEntry(key, result); <a name="l00097"></a>00097 recentdirs_done(config); <a name="l00098"></a>00098 } <a name="l00099"></a>00099 </pre></div></div> </div></div> </td> </tr> <tr> <td valign="top" id="leftmenu" width="25%"> <a name="navigation"></a> <div class="menu_box"><h2>kio/kfile</h2> <div class="nav_list"> <ul><li><a href="index.html">Main Page</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="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="classKApplicationPropsPlugin.html">kapplicationpropsplugin</option>, <option value="classKBindingPropsPlugin.html">kbindingpropsplugin</option>, <option value="classKCombiView.html">kcombiview</option>, <option value="classKDesktopPropsPlugin.html">kdesktoppropsplugin</option>, <option value="classKDevicePropsPlugin.html">kdevicepropsplugin</option>, <option value="classKDirOperator.html">kdiroperator</option>, <option value="classKDirSelectDialog.html">kdirselectdialog</option>, <option value="classKDirSize.html">kdirsize</option>, <option value="classKDiskFreeSp.html">kdiskfreesp</option>, <option value="classKEncodingFileDialog.html">kencodingfiledialog</option>, <option value="classKExecPropsPlugin.html">kexecpropsplugin</option>, <option value="classKFile.html">kfile</option>, <option value="classKFileDetailView.html">kfiledetailview</option>, <option value="classKFileDialog.html">kfiledialog</option>, <option value="classKFileIconView.html">kfileiconview</option>, <option value="classKFileIconViewItem.html">kfileiconviewitem</option>, <option value="classKFileListViewItem.html">kfilelistviewitem</option>, <option value="classKFileMetaInfoWidget.html">kfilemetainfowidget</option>, <option value="classKFileMetaPropsPlugin.html">kfilemetapropsplugin</option>, <option value="classKFileOpenWithHandler.html">kfileopenwithhandler</option>, <option value="classKFilePermissionsPropsPlugin.html">kfilepermissionspropsplugin</option>, <option value="classKFilePreview.html">kfilepreview</option>, <option value="classKFilePropsPlugin.html">kfilepropsplugin</option>, <option value="classKFileSharePropsPlugin.html">kfilesharepropsplugin</option>, <option value="classKFileTreeBranch.html">kfiletreebranch</option>, <option value="classKFileTreeView.html">kfiletreeview</option>, <option value="classKFileTreeViewItem.html">kfiletreeviewitem</option>, <option value="classKFileView.html">kfileview</option>, <option value="classKFileViewSignaler.html">kfileviewsignaler</option>, <option value="classKIconButton.html">kiconbutton</option>, <option value="classKIconCanvas.html">kiconcanvas</option>, <option value="classKIconDialog.html">kicondialog</option>, <option value="classKImageFilePreview.html">kimagefilepreview</option>, <option value="classKNotifyDialog.html">knotifydialog</option>, <option value="classKOpenWithDlg.html">kopenwithdlg</option>, <option value="classKPreviewPropsPlugin.html">kpreviewpropsplugin</option>, <option value="classKPreviewWidgetBase.html">kpreviewwidgetbase</option>, <option value="classKPropertiesDialog.html">kpropertiesdialog</option>, <option value="classKPropsDlgPlugin.html">kpropsdlgplugin</option>, <option value="classKRecentDirs.html">krecentdirs</option>, <option value="classKRecentDocument.html">krecentdocument</option>, <option value="classKURLBar.html">kurlbar</option>, <option value="classKURLBarItem.html">kurlbaritem</option>, <option value="classKURLBarItemDialog.html">kurlbaritemdialog</option>, <option value="classKURLBarListBox.html">kurlbarlistbox</option>, <option value="classKURLComboBox.html">kurlcombobox</option>, <option value="classKURLComboRequester.html">kurlcomborequester</option>, <option value="classKURLPropsPlugin.html">kurlpropsplugin</option>, <option value="classKURLRequester.html">kurlrequester</option>, <option value="classKURLRequesterDlg.html">kurlrequesterdlg</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>