Sophie

Sophie

distrib > Fedora > 15 > i386 > by-pkgid > 1f9eb832ba1e4b88d9a5c2b384813bb4 > files > 2217

kdelibs3-apidocs-3.5.10-31.fc15.noarch.rpm

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

<head>
  <title>kdecore: kcompletion.cpp Source File (kdecore)</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=".">kdecore</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 class="header">
  <div class="headertitle">
<div class="title">kcompletion.cpp</div>  </div>
</div>
<div class="contents">
<div class="fragment"><pre class="fragment"><a name="l00001"></a>00001 <span class="comment">/* This file is part of the KDE libraries</span>
<a name="l00002"></a>00002 <span class="comment">   Copyright (C) 1999,2000,2001 Carsten Pfeiffer &lt;pfeiffer@kde.org&gt;</span>
<a name="l00003"></a>00003 <span class="comment"></span>
<a name="l00004"></a>00004 <span class="comment">   This library is free software; you can redistribute it and/or</span>
<a name="l00005"></a>00005 <span class="comment">   modify it under the terms of the GNU Library General Public</span>
<a name="l00006"></a>00006 <span class="comment">   License as published by the Free Software Foundation; either</span>
<a name="l00007"></a>00007 <span class="comment">   version 2 of the License, or (at your option) any later version.</span>
<a name="l00008"></a>00008 <span class="comment"></span>
<a name="l00009"></a>00009 <span class="comment">   This library is distributed in the hope that it will be useful,</span>
<a name="l00010"></a>00010 <span class="comment">   but WITHOUT ANY WARRANTY; without even the implied warranty of</span>
<a name="l00011"></a>00011 <span class="comment">   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU</span>
<a name="l00012"></a>00012 <span class="comment">   Library General Public License for more details.</span>
<a name="l00013"></a>00013 <span class="comment"></span>
<a name="l00014"></a>00014 <span class="comment">   You should have received a copy of the GNU Library General Public License</span>
<a name="l00015"></a>00015 <span class="comment">   along with this library; see the file COPYING.LIB.  If not, write to</span>
<a name="l00016"></a>00016 <span class="comment">   the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,</span>
<a name="l00017"></a>00017 <span class="comment">   Boston, MA 02110-1301, USA.</span>
<a name="l00018"></a>00018 <span class="comment">*/</span>
<a name="l00019"></a>00019 
<a name="l00020"></a>00020 
<a name="l00021"></a>00021 <span class="preprocessor">#include &lt;kapplication.h&gt;</span>
<a name="l00022"></a>00022 <span class="preprocessor">#include &lt;kdebug.h&gt;</span>
<a name="l00023"></a>00023 <span class="preprocessor">#include &lt;<a class="code" href="klocale_8h.html">klocale.h</a>&gt;</span>
<a name="l00024"></a>00024 <span class="preprocessor">#include &lt;knotifyclient.h&gt;</span>
<a name="l00025"></a>00025 <span class="preprocessor">#include &lt;kglobal.h&gt;</span>
<a name="l00026"></a>00026 
<a name="l00027"></a>00027 <span class="preprocessor">#include &lt;qptrvector.h&gt;</span>
<a name="l00028"></a>00028 
<a name="l00029"></a>00029 <span class="preprocessor">#include &quot;kcompletion.h&quot;</span>
<a name="l00030"></a>00030 <span class="preprocessor">#include &quot;kcompletion_private.h&quot;</span>
<a name="l00031"></a>00031 
<a name="l00032"></a>00032 
<a name="l00033"></a>00033 <span class="keyword">class </span>KCompletionPrivate
<a name="l00034"></a>00034 {
<a name="l00035"></a>00035 <span class="keyword">public</span>:
<a name="l00036"></a>00036     <span class="comment">// not a member to avoid #including kcompletion_private.h from kcompletion.h</span>
<a name="l00037"></a>00037     <span class="comment">// list used for nextMatch() and previousMatch()</span>
<a name="l00038"></a>00038     KCompletionMatchesWrapper matches;
<a name="l00039"></a>00039 };
<a name="l00040"></a>00040 
<a name="l00041"></a><a class="code" href="classKCompletion.html#a67121e28f073bfc134479845cd2a2a84">00041</a> <a class="code" href="classKCompletion.html#a67121e28f073bfc134479845cd2a2a84" title="Constructor, nothing special here :)">KCompletion::KCompletion</a>()
<a name="l00042"></a>00042 {
<a name="l00043"></a>00043     d = <span class="keyword">new</span> KCompletionPrivate;
<a name="l00044"></a>00044 
<a name="l00045"></a>00045     myCompletionMode = <a class="code" href="classKCompletion.html#a59c0965af193138fe5eccac1af4b30d6" title="Return the current completion mode.">KGlobalSettings::completionMode</a>();
<a name="l00046"></a>00046     myTreeRoot = <span class="keyword">new</span> <a class="code" href="classKCompTreeNode.html" title="A helper class for KCompletion.">KCompTreeNode</a>;
<a name="l00047"></a>00047     myBeep       = <span class="keyword">true</span>;
<a name="l00048"></a>00048     myIgnoreCase = <span class="keyword">false</span>;
<a name="l00049"></a>00049     myHasMultipleMatches = <span class="keyword">false</span>;
<a name="l00050"></a>00050     myRotationIndex = 0;
<a name="l00051"></a>00051     <a class="code" href="classKCompletion.html#a77257091180054bb7d6cf280dae1dad2" title="KCompletion offers three different ways in which it offers its items:">setOrder</a>( <a class="code" href="classKCompletion.html#a88eb49b5b89f48f9296b136f6bfa9a62a2011ff90476ea031ab999c12a06e548a" title="Use order of insertion.">Insertion</a> );
<a name="l00052"></a>00052 }
<a name="l00053"></a>00053 
<a name="l00054"></a><a class="code" href="classKCompletion.html#aed35537eb98e398d9da29df0cdbf5404">00054</a> <a class="code" href="classKCompletion.html#aed35537eb98e398d9da29df0cdbf5404" title="Destructor, nothing special here, either.">KCompletion::~KCompletion</a>()
<a name="l00055"></a>00055 {
<a name="l00056"></a>00056     <span class="keyword">delete</span> d;
<a name="l00057"></a>00057     <span class="keyword">delete</span> myTreeRoot;
<a name="l00058"></a>00058 }
<a name="l00059"></a>00059 
<a name="l00060"></a><a class="code" href="classKCompletion.html#a77257091180054bb7d6cf280dae1dad2">00060</a> <span class="keywordtype">void</span> <a class="code" href="classKCompletion.html#a77257091180054bb7d6cf280dae1dad2" title="KCompletion offers three different ways in which it offers its items:">KCompletion::setOrder</a>( <a class="code" href="classKCompletion.html#a88eb49b5b89f48f9296b136f6bfa9a62" title="Constants that represent the order in which KCompletion performs completion-lookups.">CompOrder</a> order )
<a name="l00061"></a>00061 {
<a name="l00062"></a>00062     myOrder = <a class="code" href="classKCompletion.html#afaf94eeb5e57af219df24ed5a0fc875f" title="Returns the completion order.">order</a>;
<a name="l00063"></a>00063     d-&gt;matches.setSorting( order == <a class="code" href="classKCompletion.html#a88eb49b5b89f48f9296b136f6bfa9a62a968d39944eede4761a23cce8a8b06f52" title="Use weighted order.">Weighted</a> );
<a name="l00064"></a>00064 }
<a name="l00065"></a>00065 
<a name="l00066"></a><a class="code" href="classKCompletion.html#a99c356a9776a61aeaec7979a242ea51f">00066</a> <span class="keywordtype">void</span> <a class="code" href="classKCompletion.html#a99c356a9776a61aeaec7979a242ea51f" title="Setting this to true makes KCompletion behave case insensitively.">KCompletion::setIgnoreCase</a>( <span class="keywordtype">bool</span> ignoreCase )
<a name="l00067"></a>00067 {
<a name="l00068"></a>00068     myIgnoreCase = <a class="code" href="classKCompletion.html#aebd2f6ea55ac5b7b56141aa9f234b6db" title="Return whether KCompletion acts case insensitively or not.">ignoreCase</a>;
<a name="l00069"></a>00069 }
<a name="l00070"></a>00070 
<a name="l00071"></a><a class="code" href="classKCompletion.html#a0ae18e23dbba26538fc81d0e80fe2d04">00071</a> <span class="keywordtype">void</span> <a class="code" href="classKCompletion.html#a0ae18e23dbba26538fc81d0e80fe2d04" title="Sets the list of items available for completion.">KCompletion::setItems</a>( <span class="keyword">const</span> <a class="codeRef" href="qstringlist.html">QStringList</a>&amp; items )
<a name="l00072"></a>00072 {
<a name="l00073"></a>00073     <a class="code" href="classKCompletion.html#aa83d65e9084382a6ecfcf5ff2b465a9f" title="Removes all inserted items.">clear</a>();
<a name="l00074"></a>00074     <a class="code" href="classKCompletion.html#a13b8fb6f3cd37d817418c873d1032c8d" title="Inserts items into the list of possible completions.">insertItems</a>( items );
<a name="l00075"></a>00075 }
<a name="l00076"></a>00076 
<a name="l00077"></a>00077 
<a name="l00078"></a><a class="code" href="classKCompletion.html#a13b8fb6f3cd37d817418c873d1032c8d">00078</a> <span class="keywordtype">void</span> <a class="code" href="classKCompletion.html#a13b8fb6f3cd37d817418c873d1032c8d" title="Inserts items into the list of possible completions.">KCompletion::insertItems</a>( <span class="keyword">const</span> <a class="codeRef" href="qstringlist.html">QStringList</a>&amp; items )
<a name="l00079"></a>00079 {
<a name="l00080"></a>00080     <span class="keywordtype">bool</span> weighted = (myOrder == <a class="code" href="classKCompletion.html#a88eb49b5b89f48f9296b136f6bfa9a62a968d39944eede4761a23cce8a8b06f52" title="Use weighted order.">Weighted</a>);
<a name="l00081"></a>00081     QStringList::ConstIterator it;
<a name="l00082"></a>00082     <span class="keywordflow">if</span> ( weighted ) { <span class="comment">// determine weight</span>
<a name="l00083"></a>00083         <span class="keywordflow">for</span> ( it = items.begin(); it != items.end(); ++it )
<a name="l00084"></a>00084             addWeightedItem( *it );
<a name="l00085"></a>00085     }
<a name="l00086"></a>00086     <span class="keywordflow">else</span> {
<a name="l00087"></a>00087         <span class="keywordflow">for</span> ( it = items.begin(); it != items.end(); ++it )
<a name="l00088"></a>00088             <a class="code" href="classKCompletion.html#ac2e280254dc163f153077ec882f05513" title="Adds an item to the list of available completions.">addItem</a>( *it, 0 );
<a name="l00089"></a>00089     }
<a name="l00090"></a>00090 }
<a name="l00091"></a>00091 
<a name="l00092"></a>00092 <a class="codeRef" href="qstringlist.html">QStringList</a> <a class="code" href="classKCompletion.html#ad043873550c1197b3ff07e27ccb29c78" title="Returns a list of all items inserted into KCompletion.">KCompletion::items</a>()<span class="keyword"> const</span>
<a name="l00093"></a>00093 <span class="keyword"></span>{
<a name="l00094"></a>00094     KCompletionMatchesWrapper list; <span class="comment">// unsorted</span>
<a name="l00095"></a>00095     <span class="keywordtype">bool</span> addWeight = (myOrder == <a class="code" href="classKCompletion.html#a88eb49b5b89f48f9296b136f6bfa9a62a968d39944eede4761a23cce8a8b06f52" title="Use weighted order.">Weighted</a>);
<a name="l00096"></a>00096     extractStringsFromNode( myTreeRoot, QString::null, &amp;list, addWeight );
<a name="l00097"></a>00097 
<a name="l00098"></a>00098     <span class="keywordflow">return</span> list.list();
<a name="l00099"></a>00099 }
<a name="l00100"></a>00100 
<a name="l00101"></a><a class="code" href="classKCompletion.html#a7a9220a63ebe733385caeb3563e5f3b0">00101</a> <span class="keywordtype">bool</span> <a class="code" href="classKCompletion.html#a7a9220a63ebe733385caeb3563e5f3b0" title="Returns true when the completion object contains no entries.">KCompletion::isEmpty</a>()<span class="keyword"> const</span>
<a name="l00102"></a>00102 <span class="keyword"></span>{
<a name="l00103"></a>00103   <span class="keywordflow">return</span> (myTreeRoot-&gt;childrenCount() == 0);
<a name="l00104"></a>00104 }
<a name="l00105"></a>00105 
<a name="l00106"></a><a class="code" href="classKCompletion.html#ac2e280254dc163f153077ec882f05513">00106</a> <span class="keywordtype">void</span> <a class="code" href="classKCompletion.html#ac2e280254dc163f153077ec882f05513" title="Adds an item to the list of available completions.">KCompletion::addItem</a>( <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>&amp; item )
<a name="l00107"></a>00107 {
<a name="l00108"></a>00108     d-&gt;matches.clear();
<a name="l00109"></a>00109     myRotationIndex = 0;
<a name="l00110"></a>00110     myLastString = QString::null;
<a name="l00111"></a>00111 
<a name="l00112"></a>00112     <a class="code" href="classKCompletion.html#ac2e280254dc163f153077ec882f05513" title="Adds an item to the list of available completions.">addItem</a>( item, 0 );
<a name="l00113"></a>00113 }
<a name="l00114"></a>00114 
<a name="l00115"></a><a class="code" href="classKCompletion.html#a09e854a3c6d3950a9fbeb8b2cf3ecd47">00115</a> <span class="keywordtype">void</span> <a class="code" href="classKCompletion.html#ac2e280254dc163f153077ec882f05513" title="Adds an item to the list of available completions.">KCompletion::addItem</a>( <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>&amp; item, uint weight )
<a name="l00116"></a>00116 {
<a name="l00117"></a>00117     <span class="keywordflow">if</span> ( item.<a class="codeRef" href="qstring.html#isEmpty">isEmpty</a>() )
<a name="l00118"></a>00118         <span class="keywordflow">return</span>;
<a name="l00119"></a>00119 
<a name="l00120"></a>00120     <a class="code" href="classKCompTreeNode.html" title="A helper class for KCompletion.">KCompTreeNode</a> *node = myTreeRoot;
<a name="l00121"></a>00121     uint len = item.<a class="codeRef" href="qstring.html#length">length</a>();
<a name="l00122"></a>00122 
<a name="l00123"></a>00123     <span class="keywordtype">bool</span> sorted = (myOrder == <a class="code" href="classKCompletion.html#a88eb49b5b89f48f9296b136f6bfa9a62ac0b1933cc325bb144982ab09c02376db" title="Use alphabetically sorted order.">Sorted</a>);
<a name="l00124"></a>00124     <span class="keywordtype">bool</span> weighted = ((myOrder == <a class="code" href="classKCompletion.html#a88eb49b5b89f48f9296b136f6bfa9a62a968d39944eede4761a23cce8a8b06f52" title="Use weighted order.">Weighted</a>) &amp;&amp; weight &gt; 1);
<a name="l00125"></a>00125 
<a name="l00126"></a>00126     <span class="comment">// knowing the weight of an item, we simply add this weight to all of its</span>
<a name="l00127"></a>00127     <span class="comment">// nodes.</span>
<a name="l00128"></a>00128 
<a name="l00129"></a>00129     <span class="keywordflow">for</span> ( uint i = 0; i &lt; len; i++ ) {
<a name="l00130"></a>00130         node = node-&gt;insert( item.<a class="codeRef" href="qstring.html#at">at</a>(i), sorted );
<a name="l00131"></a>00131         <span class="keywordflow">if</span> ( weighted )
<a name="l00132"></a>00132             node-&gt;confirm( weight -1 ); <span class="comment">// node-&gt;insert() sets weighting to 1</span>
<a name="l00133"></a>00133     }
<a name="l00134"></a>00134 
<a name="l00135"></a>00135     <span class="comment">// add 0x0-item as delimiter with evtl. weight</span>
<a name="l00136"></a>00136     node = node-&gt;insert( 0x0, <span class="keyword">true</span> );
<a name="l00137"></a>00137     <span class="keywordflow">if</span> ( weighted )
<a name="l00138"></a>00138         node-&gt;confirm( weight -1 );
<a name="l00139"></a>00139 <span class="comment">//     qDebug(&quot;*** added: %s (%i)&quot;, item.latin1(), node-&gt;weight());</span>
<a name="l00140"></a>00140 }
<a name="l00141"></a>00141 
<a name="l00142"></a>00142 <span class="keywordtype">void</span> KCompletion::addWeightedItem( <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>&amp; item )
<a name="l00143"></a>00143 {
<a name="l00144"></a>00144     <span class="keywordflow">if</span> ( myOrder != <a class="code" href="classKCompletion.html#a88eb49b5b89f48f9296b136f6bfa9a62a968d39944eede4761a23cce8a8b06f52" title="Use weighted order.">Weighted</a> ) {
<a name="l00145"></a>00145         <a class="code" href="classKCompletion.html#ac2e280254dc163f153077ec882f05513" title="Adds an item to the list of available completions.">addItem</a>( item, 0 );
<a name="l00146"></a>00146         <span class="keywordflow">return</span>;
<a name="l00147"></a>00147     }
<a name="l00148"></a>00148 
<a name="l00149"></a>00149     uint len = item.<a class="codeRef" href="qstring.html#length">length</a>();
<a name="l00150"></a>00150     uint weight = 0;
<a name="l00151"></a>00151 
<a name="l00152"></a>00152     <span class="comment">// find out the weighting of this item (appended to the string as &quot;:num&quot;)</span>
<a name="l00153"></a>00153     <span class="keywordtype">int</span> index = item.<a class="codeRef" href="qstring.html#findRev">findRev</a>(<span class="charliteral">&#39;:&#39;</span>);
<a name="l00154"></a>00154     <span class="keywordflow">if</span> ( index &gt; 0 ) {
<a name="l00155"></a>00155         <span class="keywordtype">bool</span> ok;
<a name="l00156"></a>00156         weight = item.<a class="codeRef" href="qstring.html#mid">mid</a>( index + 1 ).toUInt( &amp;ok );
<a name="l00157"></a>00157         <span class="keywordflow">if</span> ( !ok )
<a name="l00158"></a>00158             weight = 0;
<a name="l00159"></a>00159 
<a name="l00160"></a>00160         len = index; <span class="comment">// only insert until the &#39;:&#39;</span>
<a name="l00161"></a>00161     }
<a name="l00162"></a>00162 
<a name="l00163"></a>00163     <a class="code" href="classKCompletion.html#ac2e280254dc163f153077ec882f05513" title="Adds an item to the list of available completions.">addItem</a>( item.<a class="codeRef" href="qstring.html#left">left</a>( len ), weight );
<a name="l00164"></a>00164     <span class="keywordflow">return</span>;
<a name="l00165"></a>00165 }
<a name="l00166"></a>00166 
<a name="l00167"></a>00167 
<a name="l00168"></a><a class="code" href="classKCompletion.html#a31ee8cc67ea1228ef88b0ab3e1be644d">00168</a> <span class="keywordtype">void</span> <a class="code" href="classKCompletion.html#a31ee8cc67ea1228ef88b0ab3e1be644d" title="Removes an item from the list of available completions.">KCompletion::removeItem</a>( <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>&amp; item )
<a name="l00169"></a>00169 {
<a name="l00170"></a>00170     d-&gt;matches.clear();
<a name="l00171"></a>00171     myRotationIndex = 0;
<a name="l00172"></a>00172     myLastString = QString::null;
<a name="l00173"></a>00173 
<a name="l00174"></a>00174     myTreeRoot-&gt;remove( item );
<a name="l00175"></a>00175 }
<a name="l00176"></a>00176 
<a name="l00177"></a>00177 
<a name="l00178"></a><a class="code" href="classKCompletion.html#aa83d65e9084382a6ecfcf5ff2b465a9f">00178</a> <span class="keywordtype">void</span> <a class="code" href="classKCompletion.html#aa83d65e9084382a6ecfcf5ff2b465a9f" title="Removes all inserted items.">KCompletion::clear</a>()
<a name="l00179"></a>00179 {
<a name="l00180"></a>00180     d-&gt;matches.clear();
<a name="l00181"></a>00181     myRotationIndex = 0;
<a name="l00182"></a>00182     myLastString = QString::null;
<a name="l00183"></a>00183 
<a name="l00184"></a>00184     <span class="keyword">delete</span> myTreeRoot;
<a name="l00185"></a>00185     myTreeRoot = <span class="keyword">new</span> <a class="code" href="classKCompTreeNode.html" title="A helper class for KCompletion.">KCompTreeNode</a>;
<a name="l00186"></a>00186 }
<a name="l00187"></a>00187 
<a name="l00188"></a>00188 
<a name="l00189"></a><a class="code" href="classKCompletion.html#a43b597e5d237650cc4b0e3dec50c4d2f">00189</a> <a class="codeRef" href="qstring.html">QString</a> <a class="code" href="classKCompletion.html#a43b597e5d237650cc4b0e3dec50c4d2f" title="Attempts to find an item in the list of available completions, that begins with string.">KCompletion::makeCompletion</a>( <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>&amp; <span class="keywordtype">string</span> )
<a name="l00190"></a>00190 {
<a name="l00191"></a>00191     <span class="keywordflow">if</span> ( myCompletionMode == <a class="code" href="classKGlobalSettings.html#a4df0f8e08f3ffde1e176276cbf5aa821aec030b2f4faf8614c501f54af10050a7" title="No completion is used.">KGlobalSettings::CompletionNone</a> )
<a name="l00192"></a>00192         <span class="keywordflow">return</span> QString::null;
<a name="l00193"></a>00193 
<a name="l00194"></a>00194     <span class="comment">//kdDebug(0) &lt;&lt; &quot;KCompletion: completing: &quot; &lt;&lt; string &lt;&lt; endl;</span>
<a name="l00195"></a>00195 
<a name="l00196"></a>00196     d-&gt;matches.clear();
<a name="l00197"></a>00197     myRotationIndex = 0;
<a name="l00198"></a>00198     myHasMultipleMatches = <span class="keyword">false</span>;
<a name="l00199"></a>00199     myLastMatch = myCurrentMatch;
<a name="l00200"></a>00200 
<a name="l00201"></a>00201     <span class="comment">// in Shell-completion-mode, emit all matches when we get the same</span>
<a name="l00202"></a>00202     <span class="comment">// complete-string twice</span>
<a name="l00203"></a>00203     <span class="keywordflow">if</span> ( myCompletionMode == <a class="code" href="classKGlobalSettings.html#a4df0f8e08f3ffde1e176276cbf5aa821a9ba78b1f5f1a651dd6fe08e419d73971" title="Complete text much in the same way as a typical *nix shell would.">KGlobalSettings::CompletionShell</a> &amp;&amp;
<a name="l00204"></a>00204          <span class="keywordtype">string</span> == myLastString ) {
<a name="l00205"></a>00205         <span class="comment">// Don&#39;t use d-&gt;matches since calling postProcessMatches()</span>
<a name="l00206"></a>00206         <span class="comment">// on d-&gt;matches here would interfere with call to</span>
<a name="l00207"></a>00207         <span class="comment">// postProcessMatch() during rotation</span>
<a name="l00208"></a>00208     
<a name="l00209"></a>00209         findAllCompletions( <span class="keywordtype">string</span>, &amp;d-&gt;matches, myHasMultipleMatches );
<a name="l00210"></a>00210         <a class="codeRef" href="qstringlist.html">QStringList</a> l = d-&gt;matches.list();
<a name="l00211"></a>00211         <a class="code" href="classKCompletion.html#acfe2fc542c09df5ad1f78785852b643c" title="This method is called before a list of all available completions is emitted via matches.">postProcessMatches</a>( &amp;l );
<a name="l00212"></a>00212         emit <a class="code" href="classKCompletion.html#a5b32b1facc011ba6d9cc2de31447e62b" title="All matching items.">matches</a>( l );
<a name="l00213"></a>00213 
<a name="l00214"></a>00214         <span class="keywordflow">if</span> ( l.isEmpty() )
<a name="l00215"></a>00215             doBeep( NoMatch );
<a name="l00216"></a>00216     
<a name="l00217"></a>00217         <span class="keywordflow">return</span> QString::null;
<a name="l00218"></a>00218     }
<a name="l00219"></a>00219 
<a name="l00220"></a>00220     <a class="codeRef" href="qstring.html">QString</a> completion;
<a name="l00221"></a>00221     <span class="comment">// in case-insensitive popup mode, we search all completions at once</span>
<a name="l00222"></a>00222     <span class="keywordflow">if</span> ( myCompletionMode == <a class="code" href="classKGlobalSettings.html#a4df0f8e08f3ffde1e176276cbf5aa821a0472299ebbe88d7c36b0ca5f19cd0cbe" title="Lists all possible matches in a popup list-box to choose from.">KGlobalSettings::CompletionPopup</a> ||
<a name="l00223"></a>00223          myCompletionMode == <a class="code" href="classKGlobalSettings.html#a4df0f8e08f3ffde1e176276cbf5aa821af8663fa5bbad534bbe8ddadbdea586db" title="Lists all possible matches in a popup list-box to choose from, and automatically fill the result when...">KGlobalSettings::CompletionPopupAuto</a> ) {
<a name="l00224"></a>00224         findAllCompletions( <span class="keywordtype">string</span>, &amp;d-&gt;matches, myHasMultipleMatches );
<a name="l00225"></a>00225         <span class="keywordflow">if</span> ( !d-&gt;matches.isEmpty() )
<a name="l00226"></a>00226             completion = d-&gt;matches.first();
<a name="l00227"></a>00227     }
<a name="l00228"></a>00228     <span class="keywordflow">else</span>
<a name="l00229"></a>00229         completion = findCompletion( <span class="keywordtype">string</span> );
<a name="l00230"></a>00230 
<a name="l00231"></a>00231     <span class="keywordflow">if</span> ( myHasMultipleMatches )
<a name="l00232"></a>00232         emit <a class="code" href="classKCompletion.html#a3ba213b48f41e2404150250f44626a55" title="This signal is emitted, when calling makeCompletion() and more than one matching item is found...">multipleMatches</a>();
<a name="l00233"></a>00233 
<a name="l00234"></a>00234     myLastString = string;
<a name="l00235"></a>00235     myCurrentMatch = completion;
<a name="l00236"></a>00236 
<a name="l00237"></a>00237     <a class="code" href="classKCompletion.html#a6c92b8a96accbee99418ba764e496abe" title="This method is called after a completion is found and before the matching string is emitted...">postProcessMatch</a>( &amp;completion );
<a name="l00238"></a>00238 
<a name="l00239"></a>00239     <span class="keywordflow">if</span> ( !<span class="keywordtype">string</span>.<a class="code" href="classKCompletion.html#a7a9220a63ebe733385caeb3563e5f3b0" title="Returns true when the completion object contains no entries.">isEmpty</a>() ) { <span class="comment">// only emit match when string is not empty</span>
<a name="l00240"></a>00240         <span class="comment">//kdDebug(0) &lt;&lt; &quot;KCompletion: Match: &quot; &lt;&lt; completion &lt;&lt; endl;</span>
<a name="l00241"></a>00241         emit <a class="code" href="classKCompletion.html#aa9df404d9a37d5b57ede9dd90f765116" title="The matching item.">match</a>( completion );
<a name="l00242"></a>00242     }
<a name="l00243"></a>00243 
<a name="l00244"></a>00244     <span class="keywordflow">if</span> ( completion.<a class="codeRef" href="qstring.html#isNull">isNull</a>() )
<a name="l00245"></a>00245         doBeep( NoMatch );
<a name="l00246"></a>00246 
<a name="l00247"></a>00247     <span class="keywordflow">return</span> completion;
<a name="l00248"></a>00248 }
<a name="l00249"></a>00249 
<a name="l00250"></a>00250 
<a name="l00251"></a><a class="code" href="classKCompletion.html#a02e6afb382463423c02136e6ded9a22c">00251</a> <a class="codeRef" href="qstringlist.html">QStringList</a> <a class="code" href="classKCompletion.html#a02e6afb382463423c02136e6ded9a22c" title="Returns a list of all completion items that contain the given string.">KCompletion::substringCompletion</a>( <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>&amp; <span class="keywordtype">string</span> )<span class="keyword"> const</span>
<a name="l00252"></a>00252 <span class="keyword"></span>{
<a name="l00253"></a>00253     <span class="comment">// get all items in the tree, possibly in sorted order</span>
<a name="l00254"></a>00254     <span class="keywordtype">bool</span> sorted = (myOrder == <a class="code" href="classKCompletion.html#a88eb49b5b89f48f9296b136f6bfa9a62a968d39944eede4761a23cce8a8b06f52" title="Use weighted order.">Weighted</a>);
<a name="l00255"></a>00255     KCompletionMatchesWrapper allItems( sorted );
<a name="l00256"></a>00256     extractStringsFromNode( myTreeRoot, QString::null, &amp;allItems, <span class="keyword">false</span> );
<a name="l00257"></a>00257 
<a name="l00258"></a>00258     <a class="codeRef" href="qstringlist.html">QStringList</a> list = allItems.list();
<a name="l00259"></a>00259 
<a name="l00260"></a>00260     <span class="comment">// subStringMatches is invoked manually, via a shortcut, so we should</span>
<a name="l00261"></a>00261     <span class="comment">// beep here, if necessary.</span>
<a name="l00262"></a>00262     <span class="keywordflow">if</span> ( list.isEmpty() ) {
<a name="l00263"></a>00263         doBeep( NoMatch );
<a name="l00264"></a>00264         <span class="keywordflow">return</span> list;
<a name="l00265"></a>00265     }
<a name="l00266"></a>00266 
<a name="l00267"></a>00267     <span class="keywordflow">if</span> ( <span class="keywordtype">string</span>.<a class="code" href="classKCompletion.html#a7a9220a63ebe733385caeb3563e5f3b0" title="Returns true when the completion object contains no entries.">isEmpty</a>() ) { <span class="comment">// shortcut</span>
<a name="l00268"></a>00268         <a class="code" href="classKCompletion.html#acfe2fc542c09df5ad1f78785852b643c" title="This method is called before a list of all available completions is emitted via matches.">postProcessMatches</a>( &amp;list );
<a name="l00269"></a>00269         <span class="keywordflow">return</span> list;
<a name="l00270"></a>00270     }
<a name="l00271"></a>00271 
<a name="l00272"></a>00272     <a class="codeRef" href="qstringlist.html">QStringList</a> <a class="code" href="classKCompletion.html#a5b32b1facc011ba6d9cc2de31447e62b" title="All matching items.">matches</a>;
<a name="l00273"></a>00273     QStringList::ConstIterator it = list.begin();
<a name="l00274"></a>00274 
<a name="l00275"></a>00275     <span class="keywordflow">for</span>( ; it != list.end(); ++it ) {
<a name="l00276"></a>00276         <a class="codeRef" href="qstring.html">QString</a> item = *it;
<a name="l00277"></a>00277         <span class="keywordflow">if</span> ( item.<a class="codeRef" href="qstring.html#find">find</a>( <span class="keywordtype">string</span>, 0, <span class="keyword">false</span> ) != -1 ) { <span class="comment">// always case insensitive</span>
<a name="l00278"></a>00278             matches.append( item );
<a name="l00279"></a>00279         }
<a name="l00280"></a>00280     }
<a name="l00281"></a>00281 
<a name="l00282"></a>00282     <a class="code" href="classKCompletion.html#acfe2fc542c09df5ad1f78785852b643c" title="This method is called before a list of all available completions is emitted via matches.">postProcessMatches</a>( &amp;matches );
<a name="l00283"></a>00283 
<a name="l00284"></a>00284     <span class="keywordflow">if</span> ( matches.isEmpty() )
<a name="l00285"></a>00285         doBeep( NoMatch );
<a name="l00286"></a>00286 
<a name="l00287"></a>00287     <span class="keywordflow">return</span> <a class="code" href="classKCompletion.html#a5b32b1facc011ba6d9cc2de31447e62b" title="All matching items.">matches</a>;
<a name="l00288"></a>00288 }
<a name="l00289"></a>00289 
<a name="l00290"></a>00290 
<a name="l00291"></a><a class="code" href="classKCompletion.html#ab219c989537075d60a76859ccb3c24be">00291</a> <span class="keywordtype">void</span> <a class="code" href="classKCompletion.html#ab219c989537075d60a76859ccb3c24be" title="Sets the completion mode to Auto/Manual, Shell or None.">KCompletion::setCompletionMode</a>( <a class="code" href="classKGlobalSettings.html#a4df0f8e08f3ffde1e176276cbf5aa821" title="This enum describes the completion mode used for by the KCompletion class.">KGlobalSettings::Completion</a> mode )
<a name="l00292"></a>00292 {
<a name="l00293"></a>00293     myCompletionMode = mode;
<a name="l00294"></a>00294 }
<a name="l00295"></a>00295 
<a name="l00296"></a><a class="code" href="classKCompletion.html#a5e31436d86b23b8c04b5a59a0249df65">00296</a> <a class="codeRef" href="qstringlist.html">QStringList</a> <a class="code" href="classKCompletion.html#a5e31436d86b23b8c04b5a59a0249df65" title="Returns a list of all items matching the last completed string.">KCompletion::allMatches</a>()
<a name="l00297"></a>00297 {
<a name="l00298"></a>00298     <span class="comment">// Don&#39;t use d-&gt;matches since calling postProcessMatches()</span>
<a name="l00299"></a>00299     <span class="comment">// on d-&gt;matches here would interfere with call to</span>
<a name="l00300"></a>00300     <span class="comment">// postProcessMatch() during rotation</span>
<a name="l00301"></a>00301     KCompletionMatchesWrapper <a class="code" href="classKCompletion.html#a5b32b1facc011ba6d9cc2de31447e62b" title="All matching items.">matches</a>( myOrder == <a class="code" href="classKCompletion.html#a88eb49b5b89f48f9296b136f6bfa9a62a968d39944eede4761a23cce8a8b06f52" title="Use weighted order.">Weighted</a> );
<a name="l00302"></a>00302     <span class="keywordtype">bool</span> dummy;
<a name="l00303"></a>00303     findAllCompletions( myLastString, &amp;matches, dummy );
<a name="l00304"></a>00304     <a class="codeRef" href="qstringlist.html">QStringList</a> l = matches.list();
<a name="l00305"></a>00305     <a class="code" href="classKCompletion.html#acfe2fc542c09df5ad1f78785852b643c" title="This method is called before a list of all available completions is emitted via matches.">postProcessMatches</a>( &amp;l );
<a name="l00306"></a>00306     <span class="keywordflow">return</span> l;
<a name="l00307"></a>00307 }
<a name="l00308"></a>00308 
<a name="l00309"></a><a class="code" href="classKCompletion.html#adbefa19cf6f8c44b151e6bba5f830938">00309</a> <a class="code" href="classKCompletionMatches.html" title="This structure is returned by KCompletion::allWeightedMatches .">KCompletionMatches</a> <a class="code" href="classKCompletion.html#adbefa19cf6f8c44b151e6bba5f830938" title="Returns a list of all items matching the last completed string.">KCompletion::allWeightedMatches</a>()
<a name="l00310"></a>00310 {
<a name="l00311"></a>00311     <span class="comment">// Don&#39;t use d-&gt;matches since calling postProcessMatches()</span>
<a name="l00312"></a>00312     <span class="comment">// on d-&gt;matches here would interfere with call to</span>
<a name="l00313"></a>00313     <span class="comment">// postProcessMatch() during rotation</span>
<a name="l00314"></a>00314     KCompletionMatchesWrapper <a class="code" href="classKCompletion.html#a5b32b1facc011ba6d9cc2de31447e62b" title="All matching items.">matches</a>( myOrder == <a class="code" href="classKCompletion.html#a88eb49b5b89f48f9296b136f6bfa9a62a968d39944eede4761a23cce8a8b06f52" title="Use weighted order.">Weighted</a> );
<a name="l00315"></a>00315     <span class="keywordtype">bool</span> dummy;
<a name="l00316"></a>00316     findAllCompletions( myLastString, &amp;matches, dummy );
<a name="l00317"></a>00317     <a class="code" href="classKCompletionMatches.html" title="This structure is returned by KCompletion::allWeightedMatches .">KCompletionMatches</a> ret( matches );
<a name="l00318"></a>00318     <a class="code" href="classKCompletion.html#acfe2fc542c09df5ad1f78785852b643c" title="This method is called before a list of all available completions is emitted via matches.">postProcessMatches</a>( &amp;ret );
<a name="l00319"></a>00319     <span class="keywordflow">return</span> ret;
<a name="l00320"></a>00320 }
<a name="l00321"></a>00321 
<a name="l00322"></a><a class="code" href="classKCompletion.html#aa5ad9a50eb978b94242f060fdb68bfa3">00322</a> <a class="codeRef" href="qstringlist.html">QStringList</a> <a class="code" href="classKCompletion.html#a5e31436d86b23b8c04b5a59a0249df65" title="Returns a list of all items matching the last completed string.">KCompletion::allMatches</a>( <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a> &amp;<span class="keywordtype">string</span> )
<a name="l00323"></a>00323 {
<a name="l00324"></a>00324     KCompletionMatchesWrapper <a class="code" href="classKCompletion.html#a5b32b1facc011ba6d9cc2de31447e62b" title="All matching items.">matches</a>( myOrder == <a class="code" href="classKCompletion.html#a88eb49b5b89f48f9296b136f6bfa9a62a968d39944eede4761a23cce8a8b06f52" title="Use weighted order.">Weighted</a> );
<a name="l00325"></a>00325     <span class="keywordtype">bool</span> dummy;
<a name="l00326"></a>00326     findAllCompletions( <span class="keywordtype">string</span>, &amp;matches, dummy );
<a name="l00327"></a>00327     <a class="codeRef" href="qstringlist.html">QStringList</a> l = matches.list();
<a name="l00328"></a>00328     <a class="code" href="classKCompletion.html#acfe2fc542c09df5ad1f78785852b643c" title="This method is called before a list of all available completions is emitted via matches.">postProcessMatches</a>( &amp;l );
<a name="l00329"></a>00329     <span class="keywordflow">return</span> l;
<a name="l00330"></a>00330 }
<a name="l00331"></a>00331 
<a name="l00332"></a><a class="code" href="classKCompletion.html#a6581be3dcb875c4c5a4b4b1b34d97773">00332</a> <a class="code" href="classKCompletionMatches.html" title="This structure is returned by KCompletion::allWeightedMatches .">KCompletionMatches</a> <a class="code" href="classKCompletion.html#adbefa19cf6f8c44b151e6bba5f830938" title="Returns a list of all items matching the last completed string.">KCompletion::allWeightedMatches</a>( <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a> &amp;<span class="keywordtype">string</span> )
<a name="l00333"></a>00333 {
<a name="l00334"></a>00334     KCompletionMatchesWrapper <a class="code" href="classKCompletion.html#a5b32b1facc011ba6d9cc2de31447e62b" title="All matching items.">matches</a>( myOrder == <a class="code" href="classKCompletion.html#a88eb49b5b89f48f9296b136f6bfa9a62a968d39944eede4761a23cce8a8b06f52" title="Use weighted order.">Weighted</a> );
<a name="l00335"></a>00335     <span class="keywordtype">bool</span> dummy;
<a name="l00336"></a>00336     findAllCompletions( <span class="keywordtype">string</span>, &amp;matches, dummy );
<a name="l00337"></a>00337     <a class="code" href="classKCompletionMatches.html" title="This structure is returned by KCompletion::allWeightedMatches .">KCompletionMatches</a> ret( matches );
<a name="l00338"></a>00338     <a class="code" href="classKCompletion.html#acfe2fc542c09df5ad1f78785852b643c" title="This method is called before a list of all available completions is emitted via matches.">postProcessMatches</a>( &amp;ret );
<a name="l00339"></a>00339     <span class="keywordflow">return</span> ret;
<a name="l00340"></a>00340 }
<a name="l00341"></a>00341 
<a name="l00344"></a>00344 
<a name="l00345"></a>00345 
<a name="l00346"></a><a class="code" href="classKCompletion.html#a0b42db3a570daa789b59f8b41474ad90">00346</a> <a class="codeRef" href="qstring.html">QString</a> <a class="code" href="classKCompletion.html#a0b42db3a570daa789b59f8b41474ad90" title="Returns the next item from the matching-items-list.">KCompletion::nextMatch</a>()
<a name="l00347"></a>00347 {
<a name="l00348"></a>00348     <a class="codeRef" href="qstring.html">QString</a> completion;
<a name="l00349"></a>00349     myLastMatch = myCurrentMatch;
<a name="l00350"></a>00350 
<a name="l00351"></a>00351     <span class="keywordflow">if</span> ( d-&gt;matches.isEmpty() ) {
<a name="l00352"></a>00352         findAllCompletions( myLastString, &amp;d-&gt;matches, myHasMultipleMatches );
<a name="l00353"></a>00353         completion = d-&gt;matches.first();
<a name="l00354"></a>00354         myCurrentMatch = completion;
<a name="l00355"></a>00355         myRotationIndex = 0;
<a name="l00356"></a>00356         <a class="code" href="classKCompletion.html#a6c92b8a96accbee99418ba764e496abe" title="This method is called after a completion is found and before the matching string is emitted...">postProcessMatch</a>( &amp;completion );
<a name="l00357"></a>00357         emit <a class="code" href="classKCompletion.html#aa9df404d9a37d5b57ede9dd90f765116" title="The matching item.">match</a>( completion );
<a name="l00358"></a>00358         <span class="keywordflow">return</span> completion;
<a name="l00359"></a>00359     }
<a name="l00360"></a>00360 
<a name="l00361"></a>00361     <a class="codeRef" href="qstringlist.html">QStringList</a> <a class="code" href="classKCompletion.html#a5b32b1facc011ba6d9cc2de31447e62b" title="All matching items.">matches</a> = d-&gt;matches.list();
<a name="l00362"></a>00362     myLastMatch = matches[ myRotationIndex++ ];
<a name="l00363"></a>00363 
<a name="l00364"></a>00364     <span class="keywordflow">if</span> ( myRotationIndex == matches.count() -1 )
<a name="l00365"></a>00365         doBeep( Rotation ); <span class="comment">// indicate last matching item -&gt; rotating</span>
<a name="l00366"></a>00366 
<a name="l00367"></a>00367     <span class="keywordflow">else</span> <span class="keywordflow">if</span> ( myRotationIndex == matches.count() )
<a name="l00368"></a>00368         myRotationIndex = 0;
<a name="l00369"></a>00369 
<a name="l00370"></a>00370     completion = matches[ myRotationIndex ];
<a name="l00371"></a>00371     myCurrentMatch = completion;
<a name="l00372"></a>00372     <a class="code" href="classKCompletion.html#a6c92b8a96accbee99418ba764e496abe" title="This method is called after a completion is found and before the matching string is emitted...">postProcessMatch</a>( &amp;completion );
<a name="l00373"></a>00373     emit <a class="code" href="classKCompletion.html#aa9df404d9a37d5b57ede9dd90f765116" title="The matching item.">match</a>( completion );
<a name="l00374"></a>00374     <span class="keywordflow">return</span> completion;
<a name="l00375"></a>00375 }
<a name="l00376"></a>00376 
<a name="l00377"></a>00377 
<a name="l00378"></a>00378 
<a name="l00379"></a><a class="code" href="classKCompletion.html#a9b293993541d8ed3c6ca4c67941554f2">00379</a> <a class="codeRef" href="qstring.html">QString</a> <a class="code" href="classKCompletion.html#a9b293993541d8ed3c6ca4c67941554f2" title="Returns the next item from the matching-items-list.">KCompletion::previousMatch</a>()
<a name="l00380"></a>00380 {
<a name="l00381"></a>00381     <a class="codeRef" href="qstring.html">QString</a> completion;
<a name="l00382"></a>00382     myLastMatch = myCurrentMatch;
<a name="l00383"></a>00383 
<a name="l00384"></a>00384     <span class="keywordflow">if</span> ( d-&gt;matches.isEmpty() ) {
<a name="l00385"></a>00385         findAllCompletions( myLastString, &amp;d-&gt;matches, myHasMultipleMatches );
<a name="l00386"></a>00386         completion = d-&gt;matches.last();
<a name="l00387"></a>00387         myCurrentMatch = completion;
<a name="l00388"></a>00388         myRotationIndex = 0;
<a name="l00389"></a>00389         <a class="code" href="classKCompletion.html#a6c92b8a96accbee99418ba764e496abe" title="This method is called after a completion is found and before the matching string is emitted...">postProcessMatch</a>( &amp;completion );
<a name="l00390"></a>00390         emit <a class="code" href="classKCompletion.html#aa9df404d9a37d5b57ede9dd90f765116" title="The matching item.">match</a>( completion );
<a name="l00391"></a>00391         <span class="keywordflow">return</span> completion;
<a name="l00392"></a>00392     }
<a name="l00393"></a>00393 
<a name="l00394"></a>00394     <a class="codeRef" href="qstringlist.html">QStringList</a> <a class="code" href="classKCompletion.html#a5b32b1facc011ba6d9cc2de31447e62b" title="All matching items.">matches</a> = d-&gt;matches.list();
<a name="l00395"></a>00395     myLastMatch = matches[ myRotationIndex ];
<a name="l00396"></a>00396     <span class="keywordflow">if</span> ( myRotationIndex == 1 )
<a name="l00397"></a>00397         doBeep( Rotation ); <span class="comment">// indicate first item -&gt; rotating</span>
<a name="l00398"></a>00398 
<a name="l00399"></a>00399     <span class="keywordflow">else</span> <span class="keywordflow">if</span> ( myRotationIndex == 0 )
<a name="l00400"></a>00400         myRotationIndex = matches.count();
<a name="l00401"></a>00401 
<a name="l00402"></a>00402     myRotationIndex--;
<a name="l00403"></a>00403 
<a name="l00404"></a>00404     completion = matches[ myRotationIndex ];
<a name="l00405"></a>00405     myCurrentMatch = completion;
<a name="l00406"></a>00406     <a class="code" href="classKCompletion.html#a6c92b8a96accbee99418ba764e496abe" title="This method is called after a completion is found and before the matching string is emitted...">postProcessMatch</a>( &amp;completion );
<a name="l00407"></a>00407     emit <a class="code" href="classKCompletion.html#aa9df404d9a37d5b57ede9dd90f765116" title="The matching item.">match</a>( completion );
<a name="l00408"></a>00408     <span class="keywordflow">return</span> completion;
<a name="l00409"></a>00409 }
<a name="l00410"></a>00410 
<a name="l00411"></a>00411 
<a name="l00412"></a>00412 
<a name="l00413"></a>00413 <span class="comment">// tries to complete &quot;string&quot; from the tree-root</span>
<a name="l00414"></a>00414 <a class="codeRef" href="qstring.html">QString</a> KCompletion::findCompletion( <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>&amp; <span class="keywordtype">string</span> )
<a name="l00415"></a>00415 {
<a name="l00416"></a>00416     <a class="codeRef" href="qchar.html">QChar</a> ch;
<a name="l00417"></a>00417     <a class="codeRef" href="qstring.html">QString</a> completion;
<a name="l00418"></a>00418     <span class="keyword">const</span> <a class="code" href="classKCompTreeNode.html" title="A helper class for KCompletion.">KCompTreeNode</a> *node = myTreeRoot;
<a name="l00419"></a>00419 
<a name="l00420"></a>00420     <span class="comment">// start at the tree-root and try to find the search-string</span>
<a name="l00421"></a>00421     <span class="keywordflow">for</span>( uint i = 0; i &lt; <span class="keywordtype">string</span>.length(); i++ ) {
<a name="l00422"></a>00422         ch = <span class="keywordtype">string</span>.at( i );
<a name="l00423"></a>00423         node = node-&gt;find( ch );
<a name="l00424"></a>00424 
<a name="l00425"></a>00425         <span class="keywordflow">if</span> ( node )
<a name="l00426"></a>00426             completion += ch;
<a name="l00427"></a>00427         <span class="keywordflow">else</span>
<a name="l00428"></a>00428             <span class="keywordflow">return</span> QString::null; <span class="comment">// no completion</span>
<a name="l00429"></a>00429     }
<a name="l00430"></a>00430 
<a name="l00431"></a>00431     <span class="comment">// Now we have the last node of the to be completed string.</span>
<a name="l00432"></a>00432     <span class="comment">// Follow it as long as it has exactly one child (= longest possible</span>
<a name="l00433"></a>00433     <span class="comment">// completion)</span>
<a name="l00434"></a>00434 
<a name="l00435"></a>00435     <span class="keywordflow">while</span> ( node-&gt;childrenCount() == 1 ) {
<a name="l00436"></a>00436         node = node-&gt;firstChild();
<a name="l00437"></a>00437         <span class="keywordflow">if</span> ( !node-&gt;<a class="codeRef" href="qchar.html#isNull">isNull</a>() )
<a name="l00438"></a>00438             completion += *node;
<a name="l00439"></a>00439     }
<a name="l00440"></a>00440     <span class="comment">// if multiple matches and auto-completion mode</span>
<a name="l00441"></a>00441     <span class="comment">// -&gt; find the first complete match</span>
<a name="l00442"></a>00442     <span class="keywordflow">if</span> ( node &amp;&amp; node-&gt;childrenCount() &gt; 1 ) {
<a name="l00443"></a>00443         myHasMultipleMatches = <span class="keyword">true</span>;
<a name="l00444"></a>00444     
<a name="l00445"></a>00445         <span class="keywordflow">if</span> ( myCompletionMode == <a class="code" href="classKGlobalSettings.html#a4df0f8e08f3ffde1e176276cbf5aa821ac48bfda2e5a0be4a400cf142ce99162f" title="Text is automatically filled in whenever possible.">KGlobalSettings::CompletionAuto</a> ) {
<a name="l00446"></a>00446             myRotationIndex = 1;
<a name="l00447"></a>00447             <span class="keywordflow">if</span> (myOrder != <a class="code" href="classKCompletion.html#a88eb49b5b89f48f9296b136f6bfa9a62a968d39944eede4761a23cce8a8b06f52" title="Use weighted order.">Weighted</a>) {
<a name="l00448"></a>00448                 <span class="keywordflow">while</span> ( (node = node-&gt;firstChild()) ) {
<a name="l00449"></a>00449                     <span class="keywordflow">if</span> ( !node-&gt;<a class="codeRef" href="qchar.html#isNull">isNull</a>() )
<a name="l00450"></a>00450                         completion += *node;
<a name="l00451"></a>00451                     <span class="keywordflow">else</span>
<a name="l00452"></a>00452                         <span class="keywordflow">break</span>;
<a name="l00453"></a>00453                 }
<a name="l00454"></a>00454             }
<a name="l00455"></a>00455             <span class="keywordflow">else</span> {
<a name="l00456"></a>00456                 <span class="comment">// don&#39;t just find the &quot;first&quot; match, but the one with the</span>
<a name="l00457"></a>00457                 <span class="comment">// highest priority</span>
<a name="l00458"></a>00458         
<a name="l00459"></a>00459                 <span class="keyword">const</span> <a class="code" href="classKCompTreeNode.html" title="A helper class for KCompletion.">KCompTreeNode</a>* temp_node = 0L;
<a name="l00460"></a>00460                 <span class="keywordflow">while</span>(1) {
<a name="l00461"></a>00461                     <span class="keywordtype">int</span> count = node-&gt;childrenCount();
<a name="l00462"></a>00462                     temp_node = node-&gt;firstChild();
<a name="l00463"></a>00463                     uint weight = temp_node-&gt;weight();
<a name="l00464"></a>00464                     <span class="keyword">const</span> <a class="code" href="classKCompTreeNode.html" title="A helper class for KCompletion.">KCompTreeNode</a>* hit = temp_node;
<a name="l00465"></a>00465                     <span class="keywordflow">for</span>( <span class="keywordtype">int</span> i = 1; i &lt; count; i++ ) {
<a name="l00466"></a>00466                         temp_node = node-&gt;childAt(i);
<a name="l00467"></a>00467                         <span class="keywordflow">if</span>( temp_node-&gt;weight() &gt; weight ) {
<a name="l00468"></a>00468                             hit = temp_node;
<a name="l00469"></a>00469                             weight = hit-&gt;weight();
<a name="l00470"></a>00470                         }
<a name="l00471"></a>00471                     }
<a name="l00472"></a>00472                     <span class="comment">// 0x0 has the highest priority -&gt; we have the best match</span>
<a name="l00473"></a>00473                     <span class="keywordflow">if</span> ( hit-&gt;<a class="codeRef" href="qchar.html#isNull">isNull</a>() )
<a name="l00474"></a>00474                         <span class="keywordflow">break</span>;
<a name="l00475"></a>00475 
<a name="l00476"></a>00476                     node = hit;
<a name="l00477"></a>00477                     completion += *node;
<a name="l00478"></a>00478                 }
<a name="l00479"></a>00479             }
<a name="l00480"></a>00480         }
<a name="l00481"></a>00481 
<a name="l00482"></a>00482         <span class="keywordflow">else</span>
<a name="l00483"></a>00483             doBeep( PartialMatch ); <span class="comment">// partial match -&gt; beep</span>
<a name="l00484"></a>00484     }
<a name="l00485"></a>00485 
<a name="l00486"></a>00486     <span class="keywordflow">return</span> completion;
<a name="l00487"></a>00487 }
<a name="l00488"></a>00488 
<a name="l00489"></a>00489 
<a name="l00490"></a>00490 <span class="keywordtype">void</span> KCompletion::findAllCompletions(<span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>&amp; <span class="keywordtype">string</span>,
<a name="l00491"></a>00491                                      KCompletionMatchesWrapper *matches,
<a name="l00492"></a>00492                                      <span class="keywordtype">bool</span>&amp; hasMultipleMatches)<span class="keyword"> const</span>
<a name="l00493"></a>00493 <span class="keyword"></span>{
<a name="l00494"></a>00494     <span class="comment">//kdDebug(0) &lt;&lt; &quot;*** finding all completions for &quot; &lt;&lt; string &lt;&lt; endl;</span>
<a name="l00495"></a>00495 
<a name="l00496"></a>00496     <span class="keywordflow">if</span> ( <span class="keywordtype">string</span>.<a class="code" href="classKCompletion.html#a7a9220a63ebe733385caeb3563e5f3b0" title="Returns true when the completion object contains no entries.">isEmpty</a>() )
<a name="l00497"></a>00497         <span class="keywordflow">return</span>;
<a name="l00498"></a>00498 
<a name="l00499"></a>00499     <span class="keywordflow">if</span> ( myIgnoreCase ) { <span class="comment">// case insensitive completion</span>
<a name="l00500"></a>00500         extractStringsFromNodeCI( myTreeRoot, QString::null, <span class="keywordtype">string</span>, matches );
<a name="l00501"></a>00501         hasMultipleMatches = (matches-&gt;count() &gt; 1);
<a name="l00502"></a>00502         <span class="keywordflow">return</span>;
<a name="l00503"></a>00503     }
<a name="l00504"></a>00504 
<a name="l00505"></a>00505     <a class="codeRef" href="qchar.html">QChar</a> ch;
<a name="l00506"></a>00506     <a class="codeRef" href="qstring.html">QString</a> completion;
<a name="l00507"></a>00507     <span class="keyword">const</span> <a class="code" href="classKCompTreeNode.html" title="A helper class for KCompletion.">KCompTreeNode</a> *node = myTreeRoot;
<a name="l00508"></a>00508 
<a name="l00509"></a>00509     <span class="comment">// start at the tree-root and try to find the search-string</span>
<a name="l00510"></a>00510     <span class="keywordflow">for</span>( uint i = 0; i &lt; <span class="keywordtype">string</span>.length(); i++ ) {
<a name="l00511"></a>00511         ch = <span class="keywordtype">string</span>.at( i );
<a name="l00512"></a>00512         node = node-&gt;find( ch );
<a name="l00513"></a>00513 
<a name="l00514"></a>00514         <span class="keywordflow">if</span> ( node )
<a name="l00515"></a>00515             completion += ch;
<a name="l00516"></a>00516         <span class="keywordflow">else</span>
<a name="l00517"></a>00517             <span class="keywordflow">return</span>; <span class="comment">// no completion -&gt; return empty list</span>
<a name="l00518"></a>00518     }
<a name="l00519"></a>00519     
<a name="l00520"></a>00520     <span class="comment">// Now we have the last node of the to be completed string.</span>
<a name="l00521"></a>00521     <span class="comment">// Follow it as long as it has exactly one child (= longest possible</span>
<a name="l00522"></a>00522     <span class="comment">// completion)</span>
<a name="l00523"></a>00523 
<a name="l00524"></a>00524     <span class="keywordflow">while</span> ( node-&gt;childrenCount() == 1 ) {
<a name="l00525"></a>00525         node = node-&gt;firstChild();
<a name="l00526"></a>00526         <span class="keywordflow">if</span> ( !node-&gt;<a class="codeRef" href="qchar.html#isNull">isNull</a>() )
<a name="l00527"></a>00527             completion += *node;
<a name="l00528"></a>00528         <span class="comment">// kdDebug() &lt;&lt; completion &lt;&lt; node-&gt;latin1();</span>
<a name="l00529"></a>00529     }
<a name="l00530"></a>00530 
<a name="l00531"></a>00531 
<a name="l00532"></a>00532     <span class="comment">// there is just one single match)</span>
<a name="l00533"></a>00533     <span class="keywordflow">if</span> ( node-&gt;childrenCount() == 0 )
<a name="l00534"></a>00534         matches-&gt;append( node-&gt;weight(), completion );
<a name="l00535"></a>00535 
<a name="l00536"></a>00536     <span class="keywordflow">else</span> {
<a name="l00537"></a>00537         <span class="comment">// node has more than one child</span>
<a name="l00538"></a>00538         <span class="comment">// -&gt; recursively find all remaining completions</span>
<a name="l00539"></a>00539         hasMultipleMatches = <span class="keyword">true</span>;
<a name="l00540"></a>00540         extractStringsFromNode( node, completion, matches );
<a name="l00541"></a>00541     }
<a name="l00542"></a>00542 }
<a name="l00543"></a>00543 
<a name="l00544"></a>00544 
<a name="l00545"></a>00545 <span class="keywordtype">void</span> KCompletion::extractStringsFromNode( <span class="keyword">const</span> <a class="code" href="classKCompTreeNode.html" title="A helper class for KCompletion.">KCompTreeNode</a> *node,
<a name="l00546"></a>00546                                           <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>&amp; beginning,
<a name="l00547"></a>00547                                           KCompletionMatchesWrapper *matches,
<a name="l00548"></a>00548                                           <span class="keywordtype">bool</span> addWeight )<span class="keyword"> const</span>
<a name="l00549"></a>00549 <span class="keyword"></span>{
<a name="l00550"></a>00550     <span class="keywordflow">if</span> ( !node || !matches )
<a name="l00551"></a>00551         <span class="keywordflow">return</span>;
<a name="l00552"></a>00552 
<a name="l00553"></a>00553     <span class="comment">// kDebug() &lt;&lt; &quot;Beginning: &quot; &lt;&lt; beginning &lt;&lt; endl;</span>
<a name="l00554"></a>00554     <span class="keyword">const</span> KCompTreeChildren *list = node-&gt;children();
<a name="l00555"></a>00555     <a class="codeRef" href="qstring.html">QString</a> string;
<a name="l00556"></a>00556     <a class="codeRef" href="qstring.html">QString</a> w;
<a name="l00557"></a>00557 
<a name="l00558"></a>00558     <span class="comment">// loop thru all children</span>
<a name="l00559"></a>00559     <span class="keywordflow">for</span> ( <a class="code" href="classKCompTreeNode.html" title="A helper class for KCompletion.">KCompTreeNode</a> *cur = list-&gt;begin(); cur ; cur = cur-&gt;next) {
<a name="l00560"></a>00560         <span class="keywordtype">string</span> = beginning;
<a name="l00561"></a>00561         node = cur;
<a name="l00562"></a>00562         <span class="keywordflow">if</span> ( !node-&gt;<a class="codeRef" href="qchar.html#isNull">isNull</a>() )
<a name="l00563"></a>00563             <span class="keywordtype">string</span> += *node;
<a name="l00564"></a>00564 
<a name="l00565"></a>00565         <span class="keywordflow">while</span> ( node &amp;&amp; node-&gt;childrenCount() == 1 ) {
<a name="l00566"></a>00566             node = node-&gt;firstChild();
<a name="l00567"></a>00567             <span class="keywordflow">if</span> ( node-&gt;<a class="codeRef" href="qchar.html#isNull">isNull</a>() )
<a name="l00568"></a>00568                 <span class="keywordflow">break</span>;
<a name="l00569"></a>00569             <span class="keywordtype">string</span> += *node;
<a name="l00570"></a>00570         }
<a name="l00571"></a>00571 
<a name="l00572"></a>00572         <span class="keywordflow">if</span> ( node &amp;&amp; node-&gt;<a class="codeRef" href="qchar.html#isNull">isNull</a>() ) { <span class="comment">// we found a leaf</span>
<a name="l00573"></a>00573             <span class="keywordflow">if</span> ( addWeight ) {
<a name="l00574"></a>00574                 <span class="comment">// add &quot;:num&quot; to the string to store the weighting</span>
<a name="l00575"></a>00575                 <span class="keywordtype">string</span> += <span class="charliteral">&#39;:&#39;</span>;
<a name="l00576"></a>00576                 w.<a class="codeRef" href="qstring.html#setNum">setNum</a>( node-&gt;weight() );
<a name="l00577"></a>00577                 <span class="keywordtype">string</span>.append( w );
<a name="l00578"></a>00578             }
<a name="l00579"></a>00579             matches-&gt;append( node-&gt;weight(), string );
<a name="l00580"></a>00580         }
<a name="l00581"></a>00581 
<a name="l00582"></a>00582         <span class="comment">// recursively find all other strings.</span>
<a name="l00583"></a>00583         <span class="keywordflow">if</span> ( node &amp;&amp; node-&gt;childrenCount() &gt; 1 )
<a name="l00584"></a>00584             extractStringsFromNode( node, <span class="keywordtype">string</span>, matches, addWeight );
<a name="l00585"></a>00585     }
<a name="l00586"></a>00586 }
<a name="l00587"></a>00587 
<a name="l00588"></a>00588 <span class="keywordtype">void</span> KCompletion::extractStringsFromNodeCI( <span class="keyword">const</span> <a class="code" href="classKCompTreeNode.html" title="A helper class for KCompletion.">KCompTreeNode</a> *node,
<a name="l00589"></a>00589                                             <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>&amp; beginning,
<a name="l00590"></a>00590                                             <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>&amp; restString,
<a name="l00591"></a>00591                                             KCompletionMatchesWrapper *matches )<span class="keyword"> const</span>
<a name="l00592"></a>00592 <span class="keyword"></span>{
<a name="l00593"></a>00593     <span class="keywordflow">if</span> ( restString.<a class="codeRef" href="qstring.html#isEmpty">isEmpty</a>() ) {
<a name="l00594"></a>00594         extractStringsFromNode( node, beginning, matches, <span class="keyword">false</span> <span class="comment">/*noweight*/</span> );
<a name="l00595"></a>00595         <span class="keywordflow">return</span>;
<a name="l00596"></a>00596     }
<a name="l00597"></a>00597 
<a name="l00598"></a>00598     <a class="codeRef" href="qchar.html">QChar</a> ch1 = restString.<a class="codeRef" href="qstring.html#at">at</a>(0);
<a name="l00599"></a>00599     <a class="codeRef" href="qstring.html">QString</a> newRest = restString.<a class="codeRef" href="qstring.html#mid">mid</a>(1);
<a name="l00600"></a>00600     <a class="code" href="classKCompTreeNode.html" title="A helper class for KCompletion.">KCompTreeNode</a> *child1, *child2;
<a name="l00601"></a>00601 
<a name="l00602"></a>00602     child1 = node-&gt;find( ch1 ); <span class="comment">// the correct match</span>
<a name="l00603"></a>00603     <span class="keywordflow">if</span> ( child1 )
<a name="l00604"></a>00604         extractStringsFromNodeCI( child1, beginning + *child1, newRest,
<a name="l00605"></a>00605                                   matches );
<a name="l00606"></a>00606 
<a name="l00607"></a>00607     <span class="comment">// append the case insensitive matches, if available</span>
<a name="l00608"></a>00608     <span class="keywordflow">if</span> ( ch1.<a class="codeRef" href="qchar.html#isLetter">isLetter</a>() ) {
<a name="l00609"></a>00609         <span class="comment">// find out if we have to lower or upper it. Is there a better way?</span>
<a name="l00610"></a>00610         <a class="codeRef" href="qchar.html">QChar</a> ch2 = ch1.<a class="codeRef" href="qchar.html#lower">lower</a>();
<a name="l00611"></a>00611         <span class="keywordflow">if</span> ( ch1 == ch2 )
<a name="l00612"></a>00612             ch2 = ch1.<a class="codeRef" href="qchar.html#upper">upper</a>();
<a name="l00613"></a>00613         <span class="keywordflow">if</span> ( ch1 != ch2 ) {
<a name="l00614"></a>00614             child2 = node-&gt;find( ch2 );
<a name="l00615"></a>00615             <span class="keywordflow">if</span> ( child2 )
<a name="l00616"></a>00616                 extractStringsFromNodeCI( child2, beginning + *child2, newRest,
<a name="l00617"></a>00617                                           matches );
<a name="l00618"></a>00618         }
<a name="l00619"></a>00619     }
<a name="l00620"></a>00620 }
<a name="l00621"></a>00621 
<a name="l00622"></a>00622 <span class="keywordtype">void</span> KCompletion::doBeep( BeepMode mode )<span class="keyword"> const</span>
<a name="l00623"></a>00623 <span class="keyword"></span>{
<a name="l00624"></a>00624     <span class="keywordflow">if</span> ( !myBeep )
<a name="l00625"></a>00625         <span class="keywordflow">return</span>;
<a name="l00626"></a>00626 
<a name="l00627"></a>00627     <a class="codeRef" href="qstring.html">QString</a> text, <a class="codeRef" href="qobject.html#event">event</a>;
<a name="l00628"></a>00628 
<a name="l00629"></a>00629     <span class="keywordflow">switch</span> ( mode ) {
<a name="l00630"></a>00630         <span class="keywordflow">case</span> Rotation:
<a name="l00631"></a>00631             <span class="keyword">event</span> = <a class="codeRef" href="qstring.html#fromLatin1">QString::fromLatin1</a>(<span class="stringliteral">&quot;Textcompletion: rotation&quot;</span>);
<a name="l00632"></a>00632             text = i18n(<span class="stringliteral">&quot;You reached the end of the list\nof matching items.\n&quot;</span>);
<a name="l00633"></a>00633             <span class="keywordflow">break</span>;
<a name="l00634"></a>00634         <span class="keywordflow">case</span> PartialMatch:
<a name="l00635"></a>00635             <span class="keywordflow">if</span> ( myCompletionMode == <a class="code" href="classKGlobalSettings.html#a4df0f8e08f3ffde1e176276cbf5aa821a9ba78b1f5f1a651dd6fe08e419d73971" title="Complete text much in the same way as a typical *nix shell would.">KGlobalSettings::CompletionShell</a> ||
<a name="l00636"></a>00636                  myCompletionMode == <a class="code" href="classKGlobalSettings.html#a4df0f8e08f3ffde1e176276cbf5aa821ab24ac4832b28749a17ba709a6878db1f" title="Same as automatic except shortest match is used for completion.">KGlobalSettings::CompletionMan</a> ) {
<a name="l00637"></a>00637                 <span class="keyword">event</span> = <a class="codeRef" href="qstring.html#fromLatin1">QString::fromLatin1</a>(<span class="stringliteral">&quot;Textcompletion: partial match&quot;</span>);
<a name="l00638"></a>00638                 text = i18n(<span class="stringliteral">&quot;The completion is ambiguous, more than one\nmatch is available.\n&quot;</span>);
<a name="l00639"></a>00639             }
<a name="l00640"></a>00640             <span class="keywordflow">break</span>;
<a name="l00641"></a>00641         <span class="keywordflow">case</span> NoMatch:
<a name="l00642"></a>00642             <span class="keywordflow">if</span> ( myCompletionMode == <a class="code" href="classKGlobalSettings.html#a4df0f8e08f3ffde1e176276cbf5aa821a9ba78b1f5f1a651dd6fe08e419d73971" title="Complete text much in the same way as a typical *nix shell would.">KGlobalSettings::CompletionShell</a> ) {
<a name="l00643"></a>00643                 <span class="keyword">event</span> = <a class="codeRef" href="qstring.html#fromLatin1">QString::fromLatin1</a>(<span class="stringliteral">&quot;Textcompletion: no match&quot;</span>);
<a name="l00644"></a>00644                 text = i18n(<span class="stringliteral">&quot;There is no matching item available.\n&quot;</span>);
<a name="l00645"></a>00645             }
<a name="l00646"></a>00646             <span class="keywordflow">break</span>;
<a name="l00647"></a>00647     }
<a name="l00648"></a>00648 
<a name="l00649"></a>00649     <span class="keywordflow">if</span> ( !text.<a class="codeRef" href="qstring.html#isEmpty">isEmpty</a>() )
<a name="l00650"></a>00650         <a class="code" href="namespaceKNotifyClient.html#a4057f79811e557201f9dc297541be589">KNotifyClient::event</a>( event, text );
<a name="l00651"></a>00651 }
<a name="l00652"></a>00652 
<a name="l00653"></a>00653 
<a name="l00656"></a>00656 
<a name="l00657"></a>00657 
<a name="l00658"></a>00658 <span class="comment">// Implements the tree. Every node is a QChar and has a list of children, which</span>
<a name="l00659"></a>00659 <span class="comment">// are Nodes as well.</span>
<a name="l00660"></a>00660 <span class="comment">// QChar( 0x0 ) is used as the delimiter of a string; the last child of each</span>
<a name="l00661"></a>00661 <span class="comment">// inserted string is 0x0.</span>
<a name="l00662"></a>00662 
<a name="l00663"></a>00663 KCompTreeNode::~KCompTreeNode()
<a name="l00664"></a>00664 {
<a name="l00665"></a>00665     <span class="comment">// delete all children</span>
<a name="l00666"></a>00666     <a class="code" href="classKCompTreeNode.html" title="A helper class for KCompletion.">KCompTreeNode</a> *cur = myChildren.begin();
<a name="l00667"></a>00667     <span class="keywordflow">while</span> (cur) {
<a name="l00668"></a>00668         <a class="code" href="classKCompTreeNode.html" title="A helper class for KCompletion.">KCompTreeNode</a> * next = cur-&gt;next;
<a name="l00669"></a>00669         <span class="keyword">delete</span> myChildren.remove(cur);
<a name="l00670"></a>00670         cur = next;
<a name="l00671"></a>00671     }
<a name="l00672"></a>00672 }
<a name="l00673"></a>00673 
<a name="l00674"></a>00674 
<a name="l00675"></a>00675 <span class="comment">// Adds a child-node &quot;ch&quot; to this node. If such a node is already existant,</span>
<a name="l00676"></a>00676 <span class="comment">// it will not be created. Returns the new/existing node.</span>
<a name="l00677"></a>00677 <a class="code" href="classKCompTreeNode.html" title="A helper class for KCompletion.">KCompTreeNode</a> * KCompTreeNode::insert( <span class="keyword">const</span> <a class="codeRef" href="qchar.html">QChar</a>&amp; ch, <span class="keywordtype">bool</span> sorted )
<a name="l00678"></a>00678 {
<a name="l00679"></a>00679     <a class="code" href="classKCompTreeNode.html" title="A helper class for KCompletion.">KCompTreeNode</a> *child = find( ch );
<a name="l00680"></a>00680     <span class="keywordflow">if</span> ( !child ) {
<a name="l00681"></a>00681         child = <span class="keyword">new</span> <a class="code" href="classKCompTreeNode.html" title="A helper class for KCompletion.">KCompTreeNode</a>( ch );
<a name="l00682"></a>00682 
<a name="l00683"></a>00683         <span class="comment">// FIXME, first (slow) sorted insertion implementation</span>
<a name="l00684"></a>00684         <span class="keywordflow">if</span> ( sorted ) {
<a name="l00685"></a>00685             <a class="code" href="classKCompTreeNode.html" title="A helper class for KCompletion.">KCompTreeNode</a> * prev = 0;
<a name="l00686"></a>00686             <a class="code" href="classKCompTreeNode.html" title="A helper class for KCompletion.">KCompTreeNode</a> * cur = myChildren.begin();
<a name="l00687"></a>00687             <span class="keywordflow">while</span> ( cur ) {
<a name="l00688"></a>00688                 <span class="keywordflow">if</span> ( ch &gt; *cur ) {
<a name="l00689"></a>00689                     prev = cur;
<a name="l00690"></a>00690                     cur = cur-&gt;next;
<a name="l00691"></a>00691                 } <span class="keywordflow">else</span>
<a name="l00692"></a>00692                     <span class="keywordflow">break</span>;
<a name="l00693"></a>00693             }
<a name="l00694"></a>00694             <span class="keywordflow">if</span> (prev)
<a name="l00695"></a>00695                 myChildren.insert( prev, child );
<a name="l00696"></a>00696             <span class="keywordflow">else</span>
<a name="l00697"></a>00697                 myChildren.prepend(child);
<a name="l00698"></a>00698         }
<a name="l00699"></a>00699 
<a name="l00700"></a>00700         <span class="keywordflow">else</span>
<a name="l00701"></a>00701             myChildren.append( child );
<a name="l00702"></a>00702     }
<a name="l00703"></a>00703 
<a name="l00704"></a>00704     <span class="comment">// implicit weighting: the more often an item is inserted, the higher</span>
<a name="l00705"></a>00705     <span class="comment">// priority it gets.</span>
<a name="l00706"></a>00706     child-&gt;confirm();
<a name="l00707"></a>00707 
<a name="l00708"></a>00708     <span class="keywordflow">return</span> child;
<a name="l00709"></a>00709 }
<a name="l00710"></a>00710 
<a name="l00711"></a>00711 
<a name="l00712"></a>00712 <span class="comment">// Iteratively removes a string from the tree. The nicer recursive</span>
<a name="l00713"></a>00713 <span class="comment">// version apparently was a little memory hungry (see #56757)</span>
<a name="l00714"></a>00714 <span class="keywordtype">void</span> KCompTreeNode::remove( <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>&amp; str )
<a name="l00715"></a>00715 {
<a name="l00716"></a>00716     <a class="codeRef" href="qstring.html">QString</a> <span class="keywordtype">string</span> = str;
<a name="l00717"></a>00717     <span class="keywordtype">string</span> += <a class="codeRef" href="qchar.html#QChar">QChar</a>(0x0);
<a name="l00718"></a>00718 
<a name="l00719"></a>00719     <a class="codeRef" href="qptrvector.html">QPtrVector&lt;KCompTreeNode&gt;</a> deletables( <span class="keywordtype">string</span>.length() + 1 );
<a name="l00720"></a>00720 
<a name="l00721"></a>00721     <a class="code" href="classKCompTreeNode.html" title="A helper class for KCompletion.">KCompTreeNode</a> *child = 0L;
<a name="l00722"></a>00722     <a class="code" href="classKCompTreeNode.html" title="A helper class for KCompletion.">KCompTreeNode</a> *parent = <span class="keyword">this</span>;
<a name="l00723"></a>00723     deletables.insert( 0, parent );
<a name="l00724"></a>00724     
<a name="l00725"></a>00725     uint i = 0;
<a name="l00726"></a>00726     <span class="keywordflow">for</span> ( ; i &lt; <span class="keywordtype">string</span>.length(); i++ )
<a name="l00727"></a>00727     {
<a name="l00728"></a>00728         child = parent-&gt;find( <span class="keywordtype">string</span>.at( i ) );
<a name="l00729"></a>00729         <span class="keywordflow">if</span> ( child )
<a name="l00730"></a>00730             deletables.insert( i + 1, child );
<a name="l00731"></a>00731         <span class="keywordflow">else</span>
<a name="l00732"></a>00732             <span class="keywordflow">break</span>;
<a name="l00733"></a>00733 
<a name="l00734"></a>00734         parent = child;
<a name="l00735"></a>00735     }
<a name="l00736"></a>00736 
<a name="l00737"></a>00737     <span class="keywordflow">for</span> ( ; i &gt;= 1; i-- )
<a name="l00738"></a>00738     {
<a name="l00739"></a>00739         parent = deletables.at( i - 1 );
<a name="l00740"></a>00740         child = deletables.at( i );
<a name="l00741"></a>00741         <span class="keywordflow">if</span> ( child-&gt;myChildren.count() == 0 )
<a name="l00742"></a>00742             <span class="keyword">delete</span> parent-&gt;myChildren.remove( child );
<a name="l00743"></a>00743     }
<a name="l00744"></a>00744 }
<a name="l00745"></a>00745 
<a name="l00746"></a>00746 <a class="codeRef" href="qstringlist.html">QStringList</a> KCompletionMatchesWrapper::list()<span class="keyword"> const </span>
<a name="l00747"></a>00747 <span class="keyword"></span>{
<a name="l00748"></a>00748     <span class="keywordflow">if</span> ( sortedList &amp;&amp; dirty ) {
<a name="l00749"></a>00749         sortedList-&gt;<a class="codeRef" href="qstringlist.html#sort">sort</a>();
<a name="l00750"></a>00750         dirty = <span class="keyword">false</span>;
<a name="l00751"></a>00751 
<a name="l00752"></a>00752         stringList.clear();
<a name="l00753"></a>00753 
<a name="l00754"></a>00754         <span class="comment">// high weight == sorted last -&gt; reverse the sorting here</span>
<a name="l00755"></a>00755         <a class="codeRef" href="qvaluelistconstiterator.html">QValueListConstIterator&lt;KSortableItem&lt;QString&gt;</a> &gt; it;
<a name="l00756"></a>00756         <span class="keywordflow">for</span> ( it = sortedList-&gt;begin(); it != sortedList-&gt;end(); ++it )
<a name="l00757"></a>00757             stringList.prepend( (*it).value() );
<a name="l00758"></a>00758     }
<a name="l00759"></a>00759 
<a name="l00760"></a>00760     <span class="keywordflow">return</span> stringList;
<a name="l00761"></a>00761 }
<a name="l00762"></a>00762 
<a name="l00763"></a>00763 KCompletionMatches::KCompletionMatches( <span class="keywordtype">bool</span> sort_P )
<a name="l00764"></a>00764     : _sorting( sort_P )
<a name="l00765"></a>00765 {
<a name="l00766"></a>00766 }
<a name="l00767"></a>00767 
<a name="l00768"></a>00768 KCompletionMatches::KCompletionMatches( <span class="keyword">const</span> KCompletionMatchesWrapper&amp; matches )
<a name="l00769"></a>00769     : _sorting( matches.sorting())
<a name="l00770"></a>00770 {
<a name="l00771"></a>00771     <span class="keywordflow">if</span>( matches.sortedList != 0L )
<a name="l00772"></a>00772         <a class="codeRef" href="qvaluelist.html#operator-eq">KCompletionMatchesList::operator=</a>( *matches.sortedList );
<a name="l00773"></a>00773     <span class="keywordflow">else</span> {
<a name="l00774"></a>00774         <a class="codeRef" href="qstringlist.html">QStringList</a> l = matches.list();
<a name="l00775"></a>00775         <span class="keywordflow">for</span>( QStringList::ConstIterator it = l.begin();
<a name="l00776"></a>00776              it != l.end();
<a name="l00777"></a>00777              ++it )
<a name="l00778"></a>00778             prepend( <a class="code" href="classKSortableItem.html" title="KSortableItem is a QPair that provides several operators for sorting.">KSortableItem&lt;QString, int&gt;</a>( 1, *it ) );
<a name="l00779"></a>00779     }
<a name="l00780"></a>00780 }
<a name="l00781"></a>00781 
<a name="l00782"></a>00782 KCompletionMatches::~KCompletionMatches()
<a name="l00783"></a>00783 {
<a name="l00784"></a>00784 }
<a name="l00785"></a>00785 
<a name="l00786"></a><a class="code" href="classKCompletionMatches.html#a7b3a66abe3e88d438ce928fd9956e356">00786</a> <a class="codeRef" href="qstringlist.html">QStringList</a> <a class="code" href="classKCompletionMatches.html#a7b3a66abe3e88d438ce928fd9956e356" title="Returns the matches as a QStringList.">KCompletionMatches::list</a>( <span class="keywordtype">bool</span> sort_P )<span class="keyword"> const</span>
<a name="l00787"></a>00787 <span class="keyword"></span>{
<a name="l00788"></a>00788     <span class="keywordflow">if</span>( _sorting &amp;&amp; sort_P )
<a name="l00789"></a>00789         <span class="keyword">const_cast&lt;</span> <a class="code" href="classKCompletionMatches.html" title="This structure is returned by KCompletion::allWeightedMatches .">KCompletionMatches</a>* <span class="keyword">&gt;</span>( this )-&gt;<a class="code" href="classKSortableValueList.html#aa03eb220211ac0e0d55d2018ac1f1a00" title="Sorts the KSortableItems.">sort</a>();
<a name="l00790"></a>00790     <a class="codeRef" href="qstringlist.html">QStringList</a> stringList;
<a name="l00791"></a>00791     <span class="comment">// high weight == sorted last -&gt; reverse the sorting here</span>
<a name="l00792"></a>00792     <span class="keywordflow">for</span> ( <a class="codeRef" href="qvaluelist.html#ConstIterator">ConstIterator</a> it = <a class="codeRef" href="qvaluelist.html#begin">begin</a>(); it != <a class="codeRef" href="qvaluelist.html#end">end</a>(); ++it )
<a name="l00793"></a>00793         stringList.prepend( (*it).value() );
<a name="l00794"></a>00794     <span class="keywordflow">return</span> stringList;
<a name="l00795"></a>00795 }
<a name="l00796"></a>00796 
<a name="l00797"></a><a class="code" href="classKCompletionMatches.html#a97e81d4cbda35fc0af9e4df9421d67eb">00797</a> <span class="keywordtype">void</span> <a class="code" href="classKCompletionMatches.html#a97e81d4cbda35fc0af9e4df9421d67eb" title="Removes duplicate matches.">KCompletionMatches::removeDuplicates</a>()
<a name="l00798"></a>00798 {
<a name="l00799"></a>00799     <a class="codeRef" href="qvaluelist.html#Iterator">Iterator</a> it1, it2;
<a name="l00800"></a>00800     <span class="keywordflow">for</span> ( it1 = <a class="codeRef" href="qvaluelist.html#begin">begin</a>(); it1 != <a class="codeRef" href="qvaluelist.html#end">end</a>(); ++it1 ) {
<a name="l00801"></a>00801         <span class="keywordflow">for</span> ( (it2 = it1), ++it2; it2 != <a class="codeRef" href="qvaluelist.html#end">end</a>();) {
<a name="l00802"></a>00802             <span class="keywordflow">if</span>( (*it1).value() == (*it2).value()) {
<a name="l00803"></a>00803                 <span class="comment">// use the max height</span>
<a name="l00804"></a>00804                 (*it1).first = kMax( (*it1).index(), (*it2).index());
<a name="l00805"></a>00805                 it2 = <span class="keyword">remove</span>( it2 );
<a name="l00806"></a>00806                 <span class="keywordflow">continue</span>;
<a name="l00807"></a>00807             }
<a name="l00808"></a>00808             ++it2;
<a name="l00809"></a>00809         }
<a name="l00810"></a>00810     }
<a name="l00811"></a>00811 }
<a name="l00812"></a>00812 
<a name="l00813"></a>00813 <span class="keywordtype">void</span> KCompTreeNodeList::append(<a class="code" href="classKCompTreeNode.html" title="A helper class for KCompletion.">KCompTreeNode</a> *item)
<a name="l00814"></a>00814 {
<a name="l00815"></a>00815     m_count++;
<a name="l00816"></a>00816     <span class="keywordflow">if</span> (!last) {
<a name="l00817"></a>00817         last = item;
<a name="l00818"></a>00818         last-&gt;next = 0;
<a name="l00819"></a>00819         first = item;
<a name="l00820"></a>00820         <span class="keywordflow">return</span>;
<a name="l00821"></a>00821     }
<a name="l00822"></a>00822     last-&gt;next = item;
<a name="l00823"></a>00823     item-&gt;next = 0;
<a name="l00824"></a>00824     last = item;
<a name="l00825"></a>00825 }
<a name="l00826"></a>00826 
<a name="l00827"></a>00827 <span class="keywordtype">void</span> KCompTreeNodeList::prepend(<a class="code" href="classKCompTreeNode.html" title="A helper class for KCompletion.">KCompTreeNode</a> *item)
<a name="l00828"></a>00828 {
<a name="l00829"></a>00829     m_count++;
<a name="l00830"></a>00830     <span class="keywordflow">if</span> (!last) {
<a name="l00831"></a>00831         last = item;
<a name="l00832"></a>00832         last-&gt;next = 0;
<a name="l00833"></a>00833         first = item;
<a name="l00834"></a>00834         <span class="keywordflow">return</span>;
<a name="l00835"></a>00835     }
<a name="l00836"></a>00836     item-&gt;next = first;
<a name="l00837"></a>00837     first = item;
<a name="l00838"></a>00838 }
<a name="l00839"></a>00839 
<a name="l00840"></a>00840 <span class="keywordtype">void</span> KCompTreeNodeList::insert(<a class="code" href="classKCompTreeNode.html" title="A helper class for KCompletion.">KCompTreeNode</a> *after, <a class="code" href="classKCompTreeNode.html" title="A helper class for KCompletion.">KCompTreeNode</a> *item)
<a name="l00841"></a>00841 {
<a name="l00842"></a>00842     <span class="keywordflow">if</span> (!after) {
<a name="l00843"></a>00843         append(item);
<a name="l00844"></a>00844         <span class="keywordflow">return</span>;
<a name="l00845"></a>00845     }
<a name="l00846"></a>00846 
<a name="l00847"></a>00847     m_count++;
<a name="l00848"></a>00848 
<a name="l00849"></a>00849     item-&gt;next = after-&gt;next;
<a name="l00850"></a>00850     after-&gt;next = item;
<a name="l00851"></a>00851 
<a name="l00852"></a>00852     <span class="keywordflow">if</span> (after == last)
<a name="l00853"></a>00853         last = item;
<a name="l00854"></a>00854 }
<a name="l00855"></a>00855 
<a name="l00856"></a>00856 <a class="code" href="classKCompTreeNode.html" title="A helper class for KCompletion.">KCompTreeNode</a> *KCompTreeNodeList::remove(<a class="code" href="classKCompTreeNode.html" title="A helper class for KCompletion.">KCompTreeNode</a> *item)
<a name="l00857"></a>00857 {
<a name="l00858"></a>00858     <span class="keywordflow">if</span> (!first || !item)
<a name="l00859"></a>00859         <span class="keywordflow">return</span> 0;
<a name="l00860"></a>00860     <a class="code" href="classKCompTreeNode.html" title="A helper class for KCompletion.">KCompTreeNode</a> *cur = 0;
<a name="l00861"></a>00861 
<a name="l00862"></a>00862     <span class="keywordflow">if</span> (item == first)
<a name="l00863"></a>00863         first = first-&gt;next;
<a name="l00864"></a>00864     <span class="keywordflow">else</span> {
<a name="l00865"></a>00865         cur = first;
<a name="l00866"></a>00866         <span class="keywordflow">while</span> (cur &amp;&amp; cur-&gt;next != item) cur = cur-&gt;next;
<a name="l00867"></a>00867         <span class="keywordflow">if</span> (!cur)
<a name="l00868"></a>00868             <span class="keywordflow">return</span> 0;
<a name="l00869"></a>00869         cur-&gt;next = item-&gt;next;
<a name="l00870"></a>00870     }
<a name="l00871"></a>00871     <span class="keywordflow">if</span> (item == last)
<a name="l00872"></a>00872         last = cur;
<a name="l00873"></a>00873     m_count--;
<a name="l00874"></a>00874     <span class="keywordflow">return</span> item;
<a name="l00875"></a>00875 }
<a name="l00876"></a>00876 
<a name="l00877"></a>00877 <a class="code" href="classKCompTreeNode.html" title="A helper class for KCompletion.">KCompTreeNode</a> *KCompTreeNodeList::at(uint index)<span class="keyword"> const</span>
<a name="l00878"></a>00878 <span class="keyword"></span>{
<a name="l00879"></a>00879     <a class="code" href="classKCompTreeNode.html" title="A helper class for KCompletion.">KCompTreeNode</a> *cur = first;
<a name="l00880"></a>00880     <span class="keywordflow">while</span> (index-- &amp;&amp; cur) cur = cur-&gt;next;
<a name="l00881"></a>00881     <span class="keywordflow">return</span> cur;
<a name="l00882"></a>00882 }
<a name="l00883"></a>00883 
<a name="l00884"></a>00884 <a class="code" href="classKZoneAllocator.html" title="Memory allocator for large groups of small objects.">KZoneAllocator</a> KCompTreeNode::alloc(8192);
<a name="l00885"></a>00885 
<a name="l00886"></a>00886 <span class="keywordtype">void</span> KCompletion::virtual_hook( <span class="keywordtype">int</span>, <span class="keywordtype">void</span>* )
<a name="l00887"></a>00887 { <span class="comment">/*BASE::virtual_hook( id, data );*/</span> }
<a name="l00888"></a>00888 
<a name="l00889"></a>00889 <span class="keywordtype">void</span> KCompletionBase::virtual_hook( <span class="keywordtype">int</span>, <span class="keywordtype">void</span>* )
<a name="l00890"></a>00890 { <span class="comment">/*BASE::virtual_hook( id, data );*/</span> }
<a name="l00891"></a>00891 
<a name="l00892"></a>00892 <span class="preprocessor">#include &quot;kcompletion.moc&quot;</span>
</pre></div></div>
</div>
    </div></div>


      </td>
  </tr>
  <tr>
    <td valign="top" id="leftmenu" width="25%">
      <a name="navigation"></a>
      <div class="menu_box"><h2>kdecore</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="classKAboutData.html">kaboutdata</option>,  <option value="classKAboutPerson.html">kaboutperson</option>,  <option value="classKAboutTranslator.html">kabouttranslator</option>,  <option value="classKAccel.html">kaccel</option>,  <option value="classKAcceleratorManager.html">kacceleratormanager</option>,  <option value="classKAccelManagerAlgorithm.html">kaccelmanageralgorithm</option>,  <option value="classKAccelShortcutList.html">kaccelshortcutlist</option>,  <option value="classKAccelString.html">kaccelstring</option>,  <option value="classKAddressInfo.html">kaddressinfo</option>,  <option value="classKAppDCOPInterface.html">kappdcopinterface</option>,  <option value="classKApplication.html">kapplication</option>,  <option value="classKAsyncIO.html">kasyncio</option>,  <option value="classKAudioPlayer.html">kaudioplayer</option>,  <option value="classKBufferedIO.html">kbufferedio</option>,  <option value="classKCalendarSystem.html">kcalendarsystem</option>,  <option value="classKCalendarSystemFactory.html">kcalendarsystemfactory</option>,  <option value="classKCalendarSystemJalali.html">kcalendarsystemjalali</option>,  <option value="classKCatalogue.html">kcatalogue</option>,  <option value="classKCharMacroExpander.html">kcharmacroexpander</option>,  <option value="classKCharsets.html">kcharsets</option>,  <option value="classKClipboardSynchronizer.html">kclipboardsynchronizer</option>,  <option value="classKCmdLineArgs.html">kcmdlineargs</option>,  <option value="classKCodecs.html">kcodecs</option>,  <option value="classKCompletion.html">kcompletion</option>,  <option value="classKCompletionBase.html">kcompletionbase</option>,  <option value="classKCompletionMatches.html">kcompletionmatches</option>,  <option value="classKCompTreeNode.html">kcomptreenode</option>,  <option value="classKConfig.html">kconfig</option>,  <option value="classKConfigBackEnd.html">kconfigbackend</option>,  <option value="classKConfigBase.html">kconfigbase</option>,  <option value="classKConfigDialogManager.html">kconfigdialogmanager</option>,  <option value="classKConfigGroup.html">kconfiggroup</option>,  <option value="classKConfigGroupSaver.html">kconfiggroupsaver</option>,  <option value="classKConfigINIBackEnd.html">kconfiginibackend</option>,  <option value="classKConfigSkeleton.html">kconfigskeleton</option>,  <option value="classKConfigSkeleton_1_1ItemBool.html">kconfigskeleton::itembool</option>,  <option value="classKConfigSkeleton_1_1ItemColor.html">kconfigskeleton::itemcolor</option>,  <option value="classKConfigSkeleton_1_1ItemDateTime.html">kconfigskeleton::itemdatetime</option>,  <option value="classKConfigSkeleton_1_1ItemDouble.html">kconfigskeleton::itemdouble</option>,  <option value="classKConfigSkeleton_1_1ItemEnum.html">kconfigskeleton::itemenum</option>,  <option value="classKConfigSkeleton_1_1ItemFont.html">kconfigskeleton::itemfont</option>,  <option value="classKConfigSkeleton_1_1ItemInt.html">kconfigskeleton::itemint</option>,  <option value="classKConfigSkeleton_1_1ItemInt64.html">kconfigskeleton::itemint64</option>,  <option value="classKConfigSkeleton_1_1ItemIntList.html">kconfigskeleton::itemintlist</option>,  <option value="classKConfigSkeleton_1_1ItemLong.html">kconfigskeleton::itemlong</option>,  <option value="classKConfigSkeleton_1_1ItemPassword.html">kconfigskeleton::itempassword</option>,  <option value="classKConfigSkeleton_1_1ItemPath.html">kconfigskeleton::itempath</option>,  <option value="classKConfigSkeleton_1_1ItemPathList.html">kconfigskeleton::itempathlist</option>,  <option value="classKConfigSkeleton_1_1ItemPoint.html">kconfigskeleton::itempoint</option>,  <option value="classKConfigSkeleton_1_1ItemProperty.html">kconfigskeleton::itemproperty</option>,  <option value="classKConfigSkeleton_1_1ItemRect.html">kconfigskeleton::itemrect</option>,  <option value="classKConfigSkeleton_1_1ItemSize.html">kconfigskeleton::itemsize</option>,  <option value="classKConfigSkeleton_1_1ItemString.html">kconfigskeleton::itemstring</option>,  <option value="classKConfigSkeleton_1_1ItemStringList.html">kconfigskeleton::itemstringlist</option>,  <option value="classKConfigSkeleton_1_1ItemUInt.html">kconfigskeleton::itemuint</option>,  <option value="classKConfigSkeleton_1_1ItemUInt64.html">kconfigskeleton::itemuint64</option>,  <option value="classKConfigSkeleton_1_1ItemULong.html">kconfigskeleton::itemulong</option>,  <option value="classKConfigSkeletonItem.html">kconfigskeletonitem</option>,  <option value="classKCrash.html">kcrash</option>,  <option value="classKDCOPPropertyProxy.html">kdcoppropertyproxy</option>,  <option value="classKDebugDCOPIface.html">kdebugdcopiface</option>,  <option value="classKDesktopFile.html">kdesktopfile</option>,  <option value="classKExtendedSocket.html">kextendedsocket</option>,  <option value="classKGenericFactory.html">kgenericfactory</option>,  <option value="classKGenericFactory_3_01KTypeList_3_01Product_00_01ProductListTail_01_4_00_01KTypeList_3_01Pare1ed8d1e5a9847c99711cad3b12c7e96c.html">kgenericfactory< ktypelist< product, productlisttail >, ktypelist< pare1ed8d1e5a9847c99711cad3b12c7e96c</option>,  <option value="classKGenericFactory_3_01KTypeList_3_01Product_00_01ProductListTail_01_4_00_01KTypeList_3_01Paref6a00f76851e0daa2cb662bb8a41fc7f.html">kgenericfactory< ktypelist< product, productlisttail >, ktypelist< paref6a00f76851e0daa2cb662bb8a41fc7f</option>,  <option value="classKGenericFactory_3_01KTypeList_3_01Product_00_01ProductListTail_01_4_00_01QObject_01_4.html">kgenericfactory< ktypelist< product, productlisttail >, qobject ></option>,  <option value="classKGlobal.html">kglobal</option>,  <option value="classKGlobalAccel.html">kglobalaccel</option>,  <option value="classKGlobalSettings.html">kglobalsettings</option>,  <option value="classKIcon.html">kicon</option>,  <option value="classKIconEffect.html">kiconeffect</option>,  <option value="classKIconLoader.html">kiconloader</option>,  <option value="classKIconTheme.html">kicontheme</option>,  <option value="classKInetSocketAddress.html">kinetsocketaddress</option>,  <option value="classKInstance.html">kinstance</option>,  <option value="classKIOBufferBase.html">kiobufferbase</option>,  <option value="classKIPC.html">kipc</option>,  <option value="classKKey.html">kkey</option>,  <option value="classKKeyNative.html">kkeynative</option>,  <option value="classKKeySequence.html">kkeysequence</option>,  <option value="classKLibFactory.html">klibfactory</option>,  <option value="classKLibLoader.html">klibloader</option>,  <option value="classKLibrary.html">klibrary</option>,  <option value="classKLocale.html">klocale</option>,  <option value="classKLockFile.html">klockfile</option>,  <option value="classKMacroExpanderBase.html">kmacroexpanderbase</option>,  <option value="classKMD4.html">kmd4</option>,  <option value="classKMD5.html">kmd5</option>,  <option value="classKMimeSourceFactory.html">kmimesourcefactory</option>,  <option value="classKMountPoint.html">kmountpoint</option>,  <option value="classKMultipleDrag.html">kmultipledrag</option>,  <option value="classKNetwork_1_1KActiveSocketBase.html">knetwork::kactivesocketbase</option>,  <option value="classKNetwork_1_1KBufferedSocket.html">knetwork::kbufferedsocket</option>,  <option value="classKNetwork_1_1KClientSocketBase.html">knetwork::kclientsocketbase</option>,  <option value="classKNetwork_1_1KDatagramPacket.html">knetwork::kdatagrampacket</option>,  <option value="classKNetwork_1_1KDatagramSocket.html">knetwork::kdatagramsocket</option>,  <option value="classKNetwork_1_1KHttpProxySocketDevice.html">knetwork::khttpproxysocketdevice</option>,  <option value="classKNetwork_1_1KInetSocketAddress.html">knetwork::kinetsocketaddress</option>,  <option value="classKNetwork_1_1KIpAddress.html">knetwork::kipaddress</option>,  <option value="classKNetwork_1_1KMulticastSocket.html">knetwork::kmulticastsocket</option>,  <option value="classKNetwork_1_1KMulticastSocketImpl.html">knetwork::kmulticastsocketimpl</option>,  <option value="classKNetwork_1_1KNetworkInterface.html">knetwork::knetworkinterface</option>,  <option value="classKNetwork_1_1KPassiveSocketBase.html">knetwork::kpassivesocketbase</option>,  <option value="classKNetwork_1_1KResolver.html">knetwork::kresolver</option>,  <option value="classKNetwork_1_1KResolverEntry.html">knetwork::kresolverentry</option>,  <option value="classKNetwork_1_1KResolverResults.html">knetwork::kresolverresults</option>,  <option value="classKNetwork_1_1KResolverWorkerBase_1_1ResolverLocker.html">knetwork::kresolverworkerbase::resolverlocker</option>,  <option value="classKNetwork_1_1KReverseResolver.html">knetwork::kreverseresolver</option>,  <option value="classKNetwork_1_1KServerSocket.html">knetwork::kserversocket</option>,  <option value="classKNetwork_1_1KSocketAddress.html">knetwork::ksocketaddress</option>,  <option value="classKNetwork_1_1KSocketBase.html">knetwork::ksocketbase</option>,  <option value="classKNetwork_1_1KSocketDevice.html">knetwork::ksocketdevice</option>,  <option value="classKNetwork_1_1KSocketDeviceFactory.html">knetwork::ksocketdevicefactory</option>,  <option value="classKNetwork_1_1KSocksSocketDevice.html">knetwork::ksockssocketdevice</option>,  <option value="classKNetwork_1_1KStreamSocket.html">knetwork::kstreamsocket</option>,  <option value="classKNetwork_1_1KUnixSocketAddress.html">knetwork::kunixsocketaddress</option>,  <option value="classKNotifyClient_1_1Instance.html">knotifyclient::instance</option>,  <option value="classKPalette.html">kpalette</option>,  <option value="classKPixmapProvider.html">kpixmapprovider</option>,  <option value="classKPopupAccelManager.html">kpopupaccelmanager</option>,  <option value="classKProcess.html">kprocess</option>,  <option value="classKProcessController.html">kprocesscontroller</option>,  <option value="classKProcIO.html">kprocio</option>,  <option value="classKProtocolInfoFactory.html">kprotocolinfofactory</option>,  <option value="classKPty.html">kpty</option>,  <option value="classKRandomSequence.html">krandomsequence</option>,  <option value="classKRegExp.html">kregexp</option>,  <option value="classKRegExpPrivate.html">kregexpprivate</option>,  <option value="classKRFCDate.html">krfcdate</option>,  <option value="classKRootProp.html">krootprop</option>,  <option value="classKSaveFile.html">ksavefile</option>,  <option value="classKServerSocket.html">kserversocket</option>,  <option value="classKSessionManaged.html">ksessionmanaged</option>,  <option value="classKShared.html">kshared</option>,  <option value="classKSharedConfig.html">ksharedconfig</option>,  <option value="classKSharedPtr.html">ksharedptr</option>,  <option value="classKShellProcess.html">kshellprocess</option>,  <option value="classKShortcut.html">kshortcut</option>,  <option value="classKShortcutList.html">kshortcutlist</option>,  <option value="classKSimpleConfig.html">ksimpleconfig</option>,  <option value="classKSocket.html">ksocket</option>,  <option value="classKSocketAddress.html">ksocketaddress</option>,  <option value="classKSocks.html">ksocks</option>,  <option value="classKSortableItem.html">ksortableitem</option>,  <option value="classKSortableValueList.html">ksortablevaluelist</option>,  <option value="classKStandardDirs.html">kstandarddirs</option>,  <option value="classKStaticDeleter.html">kstaticdeleter</option>,  <option value="classKStaticDeleterBase.html">kstaticdeleterbase</option>,  <option value="classKStdAccel_1_1ShortcutList.html">kstdaccel::shortcutlist</option>,  <option value="classKStringHandler.html">kstringhandler</option>,  <option value="classKSycocaEntry.html">ksycocaentry</option>,  <option value="classKSycocaFactoryList.html">ksycocafactorylist</option>,  <option value="classKTempDir.html">ktempdir</option>,  <option value="classKTempFile.html">ktempfile</option>,  <option value="classKTimezone.html">ktimezone</option>,  <option value="classKTimezoneDetails.html">ktimezonedetails</option>,  <option value="classKTimezones.html">ktimezones</option>,  <option value="classKTimezoneSource.html">ktimezonesource</option>,  <option value="classKUniqueApplication.html">kuniqueapplication</option>,  <option value="classKUnixSocketAddress.html">kunixsocketaddress</option>,  <option value="classKURL.html">kurl</option>,  <option value="classKURL_1_1List.html">kurl::list</option>,  <option value="classKURLDrag.html">kurldrag</option>,  <option value="classKUser.html">kuser</option>,  <option value="classKUserGroup.html">kusergroup</option>,  <option value="classKVMAllocator.html">kvmallocator</option>,  <option value="classKWin.html">kwin</option>,  <option value="classKWin_1_1WindowInfo.html">kwin::windowinfo</option>,  <option value="classKWinModule.html">kwinmodule</option>,  <option value="classKWordMacroExpander.html">kwordmacroexpander</option>,  <option value="classKXErrorHandler.html">kxerrorhandler</option>,  <option value="classKZoneAllocator.html">kzoneallocator</option>,  <option value="classNET.html">net</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>&nbsp;&nbsp;&nbsp;&nbsp;<a href="../../interfaces/kimproxy/interface/html/index.html">interface</a></li><li>&nbsp;&nbsp;&nbsp;&nbsp;<a href="../../interfaces/kimproxy/library/html/index.html">library</a></li><li>&nbsp;&nbsp;<a href="../../interfaces/kspeech/html/index.html">kspeech</a></li><li>&nbsp;&nbsp;<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>&nbsp;&nbsp;<a href="../../kio/bookmarks/html/index.html">bookmarks</a></li><li>&nbsp;&nbsp;<a href="../../kio/httpfilter/html/index.html">httpfilter</a></li><li>&nbsp;&nbsp;<a href="../../kio/kfile/html/index.html">kfile</a></li><li>&nbsp;&nbsp;<a href="../../kio/kio/html/index.html">kio</a></li><li>&nbsp;&nbsp;<a href="../../kio/kioexec/html/index.html">kioexec</a></li><li>&nbsp;&nbsp;<a href="../../kio/kpasswdserver/html/index.html">kpasswdserver</a></li><li>&nbsp;&nbsp;<a href="../../kio/kssl/html/index.html">kssl</a></li><li><a href="../../kioslave/html/index.html">kioslave</a></li><li>&nbsp;&nbsp;<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>&nbsp;&nbsp;<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="&#109;&#97;&#105;&#108;&#116;&#111;&#58;groo&#116;&#64;kde&#46;or&#x67;">Adriaan de Groot</a>
and
<a href="&#109;a&#105;&#108;&#116;&#111;&#58;w&#105;nter&#64;kde&#46;or&#x67">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>