Sophie

Sophie

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

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>kio/kio: kfilemetainfo.cpp Source File (kio/kio)</title>
  <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />

  <meta http-equiv="Content-Style-Type" content="text/css" />

  <meta http-equiv="pics-label" content='(pics-1.1 "http://www.icra.org/ratingsv02.html" comment "ICRAonline DE v2.0" l gen true for "http://www.kde.org"  r (nz 1 vz 1 lz 1 oz 1 cb 1) "http://www.rsac.org/ratingsv01.html" l gen true for "http://www.kde.org"  r (n 0 s 0 v 0 l 0))' />

  <meta name="trademark" content="KDE e.V." />
  <meta name="description" content="K Desktop Environment Homepage, KDE.org" />
  <meta name="MSSmartTagsPreventParsing" content="true" />
  <meta name="robots" content="all" />

  <link rel="shortcut icon" href="../../../favicon.ico" />

<link rel="stylesheet" media="screen" type="text/css" title="APIDOX" href="doxygen.css" />



</head>

<body>

<div id="nav_header_top" align="right">
  <a href="#content" class="doNotDisplay" accesskey="2">Skip to main content ::</a>

  <a href="../../.."><img id="nav_header_logo" alt="Home" align="left" src="../../../kde_gear_64.png" border="0" /></a>
  <span class="doNotDisplay">::</span>

  <div id="nav_header_title" align="left">KDE API Reference</div>


</div>

<div id="nav_header_bottom" align="right">
  <span class="doNotDisplay">:: <a href="#navigation" accesskey="5">Skip to Link Menu</a><br/></span>
  <div id="nav_header_bottom_right" style="text-align: left;">
/ <a href="../../..">API Reference</a>
 / <a href="../../html/index.html">kio</a> / <a href=".">kio</a>
  </div>
</div>


<table id="main" border="0" cellpadding="0" cellspacing="0" width="100%">
<tr>
      <td valign="top" class="menuheader" height="0"></td>

  <td id="contentcolumn" valign="top" rowspan="2" >
    <div id="content" style="padding-top: 0px;"><div style="width:100%; margin: 0px; padding: 0px;">
    <a name="content"></a>


<!-- Generated by Doxygen 1.7.4 -->
<div class="header">
  <div class="headertitle">
<div class="title">kfilemetainfo.cpp</div>  </div>
</div>
<div class="contents">
<div class="fragment"><pre class="fragment"><a name="l00001"></a>00001 <span class="comment">/*</span>
<a name="l00002"></a>00002 <span class="comment"> *  This file is part of the KDE libraries</span>
<a name="l00003"></a>00003 <span class="comment"> *  Copyright (C) 2001-2002 Rolf Magnus &lt;ramagnus@kde.org&gt;</span>
<a name="l00004"></a>00004 <span class="comment"> *  Copyright (C) 2001-2002 Carsten Pfeiffer &lt;pfeiffer@kde.org&gt;</span>
<a name="l00005"></a>00005 <span class="comment"> *</span>
<a name="l00006"></a>00006 <span class="comment"> *  This library is free software; you can redistribute it and/or</span>
<a name="l00007"></a>00007 <span class="comment"> *  modify it under the terms of the GNU Library General Public</span>
<a name="l00008"></a>00008 <span class="comment"> *  License as published by the Free Software Foundation version 2.0.</span>
<a name="l00009"></a>00009 <span class="comment"> *</span>
<a name="l00010"></a>00010 <span class="comment"> *  This library is distributed in the hope that it will be useful,</span>
<a name="l00011"></a>00011 <span class="comment"> *  but WITHOUT ANY WARRANTY; without even the implied warranty of</span>
<a name="l00012"></a>00012 <span class="comment"> *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU</span>
<a name="l00013"></a>00013 <span class="comment"> *  Library General Public License for more details.</span>
<a name="l00014"></a>00014 <span class="comment"> *</span>
<a name="l00015"></a>00015 <span class="comment"> *  You should have received a copy of the GNU Library General Public License</span>
<a name="l00016"></a>00016 <span class="comment"> *  along with this library; see the file COPYING.LIB.  If not, write to</span>
<a name="l00017"></a>00017 <span class="comment"> *  the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,</span>
<a name="l00018"></a>00018 <span class="comment"> *  Boston, MA 02110-1301, USA.</span>
<a name="l00019"></a>00019 <span class="comment"> *</span>
<a name="l00020"></a>00020 <span class="comment"> *  $Id: kfilemetainfo.cpp 585308 2006-09-16 23:00:15Z kling $</span>
<a name="l00021"></a>00021 <span class="comment"> */</span>
<a name="l00022"></a>00022 
<a name="l00023"></a>00023 <span class="preprocessor">#include &lt;assert.h&gt;</span>
<a name="l00024"></a>00024 
<a name="l00025"></a>00025 <span class="preprocessor">#include &lt;qshared.h&gt;</span>
<a name="l00026"></a>00026 <span class="preprocessor">#include &lt;qdict.h&gt;</span>
<a name="l00027"></a>00027 
<a name="l00028"></a>00028 <span class="preprocessor">#include &lt;ktrader.h&gt;</span>
<a name="l00029"></a>00029 <span class="preprocessor">#include &lt;kstaticdeleter.h&gt;</span>
<a name="l00030"></a>00030 <span class="preprocessor">#include &lt;kparts/componentfactory.h&gt;</span>
<a name="l00031"></a>00031 <span class="preprocessor">#include &lt;kuserprofile.h&gt;</span>
<a name="l00032"></a>00032 <span class="preprocessor">#include &lt;kdebug.h&gt;</span>
<a name="l00033"></a>00033 <span class="preprocessor">#include &lt;kmimetype.h&gt;</span>
<a name="l00034"></a>00034 <span class="preprocessor">#include &lt;kdatastream.h&gt;</span> <span class="comment">// needed for serialization of bool</span>
<a name="l00035"></a>00035 <span class="preprocessor">#include &lt;klocale.h&gt;</span>
<a name="l00036"></a>00036 <span class="preprocessor">#include &lt;kio/global.h&gt;</span>
<a name="l00037"></a>00037 
<a name="l00038"></a>00038 <span class="preprocessor">#include &quot;kfilemetainfo.h&quot;</span>
<a name="l00039"></a>00039 
<a name="l00040"></a>00040 <span class="comment">// shared data of a KFileMetaInfoItem</span>
<a name="l00041"></a>00041 <span class="keyword">class </span>KFileMetaInfoItem::Data : <span class="keyword">public</span> QShared
<a name="l00042"></a>00042 {
<a name="l00043"></a>00043 <span class="keyword">public</span>:
<a name="l00044"></a>00044     Data( <span class="keyword">const</span> <a class="code" href="classKFileMimeTypeInfo_1_1ItemInfo.html" title="This is the class for one item of a KFileMimeTypeInfo.">KFileMimeTypeInfo::ItemInfo</a>* mti, <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>&amp; _key,
<a name="l00045"></a>00045           <span class="keyword">const</span> <a class="codeRef" href="qvariant.html">QVariant</a>&amp; _value )
<a name="l00046"></a>00046         : QShared(),
<a name="l00047"></a>00047           mimeTypeInfo( mti ),
<a name="l00048"></a>00048           <a class="code" href="classKFileMetaInfoItem.html#a4cc4ba436fdd31f3f367df2bced02eac" title="Returns the key of the item.">key</a>( _key ),
<a name="l00049"></a>00049           <a class="code" href="classKFileMetaInfoItem.html#a2032cf0c915161ad031da15018db1427" title="Returns the value of the item.">value</a>( _value ),
<a name="l00050"></a>00050           dirty( false ),
<a name="l00051"></a>00051           added( false ),
<a name="l00052"></a>00052           removed( false )
<a name="l00053"></a>00053     {}
<a name="l00054"></a>00054 
<a name="l00055"></a>00055     <span class="comment">// we use this one for the streaming operators</span>
<a name="l00056"></a>00056     Data() : mimeTypeInfo( 0L )
<a name="l00057"></a>00057     {}
<a name="l00058"></a>00058 
<a name="l00059"></a>00059     ~Data()
<a name="l00060"></a>00060     {
<a name="l00061"></a>00061         <span class="keywordflow">if</span> ( <span class="keyword">this</span> == null ) <span class="comment">// only the null item owns its mimeTypeInfo</span>
<a name="l00062"></a>00062             <span class="keyword">delete</span> mimeTypeInfo;
<a name="l00063"></a>00063     }
<a name="l00064"></a>00064 
<a name="l00065"></a>00065     <span class="keyword">const</span> <a class="code" href="classKFileMimeTypeInfo_1_1ItemInfo.html" title="This is the class for one item of a KFileMimeTypeInfo.">KFileMimeTypeInfo::ItemInfo</a>*  mimeTypeInfo;
<a name="l00066"></a>00066     <span class="comment">// mimeTypeInfo has the key, too, but only for non-variable ones</span>
<a name="l00067"></a>00067     <a class="codeRef" href="qstring.html">QString</a>                             <a class="code" href="classKFileMetaInfoItem.html#a4cc4ba436fdd31f3f367df2bced02eac" title="Returns the key of the item.">key</a>;
<a name="l00068"></a>00068     <a class="codeRef" href="qvariant.html">QVariant</a>                            <a class="code" href="classKFileMetaInfoItem.html#a2032cf0c915161ad031da15018db1427" title="Returns the value of the item.">value</a>;
<a name="l00069"></a>00069     <span class="keywordtype">bool</span>                                dirty    :1;
<a name="l00070"></a>00070     <span class="keywordtype">bool</span>                                added    :1;
<a name="l00071"></a>00071     <span class="keywordtype">bool</span>                                removed  :1;
<a name="l00072"></a>00072 
<a name="l00073"></a>00073     <span class="keyword">static</span> Data* null;
<a name="l00074"></a>00074     <span class="keyword">static</span> Data* makeNull();
<a name="l00075"></a>00075 };
<a name="l00076"></a>00076 
<a name="l00077"></a>00077 <span class="comment">//this is our null data</span>
<a name="l00078"></a>00078 KFileMetaInfoItem::Data* KFileMetaInfoItem::Data::null = 0L;
<a name="l00079"></a>00079 <span class="keyword">static</span> KStaticDeleter&lt;KFileMetaInfoItem::Data&gt; sd_KFileMetaInfoItemData;
<a name="l00080"></a>00080 
<a name="l00081"></a>00081 KFileMetaInfoItem::Data* KFileMetaInfoItem::Data::makeNull()
<a name="l00082"></a>00082 {
<a name="l00083"></a>00083     <span class="keywordflow">if</span> (!null)
<a name="l00084"></a>00084     {
<a name="l00085"></a>00085         <span class="comment">// We deliberately do not reset &quot;null&quot; after it has been destroyed!</span>
<a name="l00086"></a>00086         <span class="comment">// Otherwise we will run into problems later in ~KFileMetaInfoItem</span>
<a name="l00087"></a>00087         <span class="comment">// where the d-pointer is compared against null.</span>
<a name="l00088"></a>00088 
<a name="l00089"></a>00089         <a class="code" href="classKFileMimeTypeInfo_1_1ItemInfo.html" title="This is the class for one item of a KFileMimeTypeInfo.">KFileMimeTypeInfo::ItemInfo</a>* info = <span class="keyword">new</span> <a class="code" href="classKFileMimeTypeInfo_1_1ItemInfo.html" title="This is the class for one item of a KFileMimeTypeInfo.">KFileMimeTypeInfo::ItemInfo</a>();
<a name="l00090"></a>00090         null = <span class="keyword">new</span> Data(info, QString::null, <a class="codeRef" href="qvariant.html">QVariant</a>());
<a name="l00091"></a>00091         sd_KFileMetaInfoItemData.setObject( null );
<a name="l00092"></a>00092     }
<a name="l00093"></a>00093     <span class="keywordflow">return</span> null;
<a name="l00094"></a>00094 }
<a name="l00095"></a>00095 
<a name="l00096"></a>00096 <a class="code" href="classKFileMetaInfoItem.html#abd72e8f72502f0b62713ee9e8f56f891" title="Default constructor.">KFileMetaInfoItem::KFileMetaInfoItem</a>( <span class="keyword">const</span> <a class="code" href="classKFileMimeTypeInfo_1_1ItemInfo.html" title="This is the class for one item of a KFileMimeTypeInfo.">KFileMimeTypeInfo::ItemInfo</a>* mti,
<a name="l00097"></a>00097                                       <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>&amp; key, <span class="keyword">const</span> <a class="codeRef" href="qvariant.html">QVariant</a>&amp; value )
<a name="l00098"></a>00098     : d( new Data( mti, key, value ) )
<a name="l00099"></a>00099 {
<a name="l00100"></a>00100 }
<a name="l00101"></a>00101 
<a name="l00102"></a><a class="code" href="classKFileMetaInfoItem.html#a76dc6da795809ef4f889c51351281089">00102</a> <a class="code" href="classKFileMetaInfoItem.html#abd72e8f72502f0b62713ee9e8f56f891" title="Default constructor.">KFileMetaInfoItem::KFileMetaInfoItem</a>( <span class="keyword">const</span> <a class="code" href="classKFileMetaInfoItem.html" title="A meta information item about a file.">KFileMetaInfoItem</a>&amp; item )
<a name="l00103"></a>00103 {
<a name="l00104"></a>00104     <span class="comment">// operator= does everything that&#39;s necessary</span>
<a name="l00105"></a>00105     d = Data::makeNull();
<a name="l00106"></a>00106     *<span class="keyword">this</span> = item;
<a name="l00107"></a>00107 }
<a name="l00108"></a>00108 
<a name="l00109"></a><a class="code" href="classKFileMetaInfoItem.html#abd72e8f72502f0b62713ee9e8f56f891">00109</a> <a class="code" href="classKFileMetaInfoItem.html#abd72e8f72502f0b62713ee9e8f56f891" title="Default constructor.">KFileMetaInfoItem::KFileMetaInfoItem</a>()
<a name="l00110"></a>00110 {
<a name="l00111"></a>00111     d = Data::makeNull();
<a name="l00112"></a>00112 }
<a name="l00113"></a>00113 
<a name="l00114"></a>00114 KFileMetaInfoItem::~KFileMetaInfoItem()
<a name="l00115"></a>00115 {
<a name="l00116"></a>00116     deref();
<a name="l00117"></a>00117 }
<a name="l00118"></a>00118 
<a name="l00119"></a>00119 <span class="keyword">const</span> <a class="code" href="classKFileMetaInfoItem.html" title="A meta information item about a file.">KFileMetaInfoItem</a>&amp; KFileMetaInfoItem::operator=
<a name="l00120"></a><a class="code" href="classKFileMetaInfoItem.html#a57a613030f96ce30d24e98117cd29368">00120</a>                                               (<span class="keyword">const</span> <a class="code" href="classKFileMetaInfoItem.html" title="A meta information item about a file.">KFileMetaInfoItem</a> &amp; item )
<a name="l00121"></a>00121 {
<a name="l00122"></a>00122     <span class="keywordflow">if</span> (d != item.d)
<a name="l00123"></a>00123     {
<a name="l00124"></a>00124         <span class="comment">// first deref the old one</span>
<a name="l00125"></a>00125         deref();
<a name="l00126"></a>00126         d = item.d;
<a name="l00127"></a>00127         <span class="comment">// and now ref the new one</span>
<a name="l00128"></a>00128         ref();
<a name="l00129"></a>00129     }
<a name="l00130"></a>00130 
<a name="l00131"></a>00131     <span class="keywordflow">return</span> *<span class="keyword">this</span>;
<a name="l00132"></a>00132 }
<a name="l00133"></a>00133 
<a name="l00134"></a><a class="code" href="classKFileMetaInfoItem.html#a6aac19b921c027675622729e6a6f8d16">00134</a> <span class="keywordtype">bool</span> <a class="code" href="classKFileMetaInfoItem.html#a6aac19b921c027675622729e6a6f8d16" title="Changes the value of the item.">KFileMetaInfoItem::setValue</a>( <span class="keyword">const</span> <a class="codeRef" href="qvariant.html">QVariant</a>&amp; value )
<a name="l00135"></a>00135 {
<a name="l00136"></a>00136     <span class="comment">// We don&#39;t call makeNull here since it isn&#39;t necassery, see deref()</span>
<a name="l00137"></a>00137     <span class="keywordflow">if</span> ( d == Data::null ) <span class="keywordflow">return</span> <span class="keyword">false</span>;
<a name="l00138"></a>00138 
<a name="l00139"></a>00139     <span class="keywordflow">if</span> ( ! (d-&gt;mimeTypeInfo-&gt;attributes() &amp; <a class="code" href="classKFileMimeTypeInfo.html#a5d4779692b425b43302a9a113f91d59aa3d6a31c195c36a2368fbc7fa34483365" title="The value can be edited (no meaning for a group)">KFileMimeTypeInfo::Modifiable</a> ) ||
<a name="l00140"></a>00140          ! (value.<a class="codeRef" href="qvariant.html#canCast">canCast</a>(d-&gt;mimeTypeInfo-&gt;type())))
<a name="l00141"></a>00141     {
<a name="l00142"></a>00142         kdDebug(7033) &lt;&lt; <span class="stringliteral">&quot;setting the value of &quot;</span> &lt;&lt; <a class="code" href="classKFileMetaInfoItem.html#a4cc4ba436fdd31f3f367df2bced02eac" title="Returns the key of the item.">key</a>() &lt;&lt; <span class="stringliteral">&quot;failed\n&quot;</span>;
<a name="l00143"></a>00143         <span class="keywordflow">return</span> <span class="keyword">false</span>;
<a name="l00144"></a>00144     }
<a name="l00145"></a>00145 
<a name="l00146"></a>00146 <span class="comment">//    kdDebug(7033) &lt;&lt; key() &lt;&lt; &quot;.setValue()\n&quot;;</span>
<a name="l00147"></a>00147 
<a name="l00148"></a>00148     <span class="keywordflow">if</span> ( d-&gt;value == value )
<a name="l00149"></a>00149         <span class="keywordflow">return</span> <span class="keyword">true</span>;
<a name="l00150"></a>00150 
<a name="l00151"></a>00151     d-&gt;dirty = <span class="keyword">true</span>;
<a name="l00152"></a>00152     d-&gt;value = <a class="code" href="classKFileMetaInfoItem.html#a2032cf0c915161ad031da15018db1427" title="Returns the value of the item.">value</a>;
<a name="l00153"></a>00153     <span class="comment">// If we don&#39;t cast (and test for canCast in the above if), QVariant is</span>
<a name="l00154"></a>00154     <span class="comment">// very picky about types (e.g. QString vs. QCString or int vs. uint)</span>
<a name="l00155"></a>00155     d-&gt;value.cast(d-&gt;mimeTypeInfo-&gt;type());
<a name="l00156"></a>00156 
<a name="l00157"></a>00157     <span class="keywordflow">return</span> <span class="keyword">true</span>;
<a name="l00158"></a>00158 }
<a name="l00159"></a>00159 
<a name="l00160"></a><a class="code" href="classKFileMetaInfoItem.html#a8ea27f57af7a75fe1ec006b6e178cc24">00160</a> <span class="keywordtype">bool</span> <a class="code" href="classKFileMetaInfoItem.html#a8ea27f57af7a75fe1ec006b6e178cc24" title="If you remove an item, it is only marked for removal for the file.">KFileMetaInfoItem::isRemoved</a>()<span class="keyword"> const</span>
<a name="l00161"></a>00161 <span class="keyword"></span>{
<a name="l00162"></a>00162     <span class="keywordflow">return</span> d-&gt;removed;
<a name="l00163"></a>00163 }
<a name="l00164"></a>00164 
<a name="l00165"></a><a class="code" href="classKFileMetaInfoItem.html#a4cc4ba436fdd31f3f367df2bced02eac">00165</a> <a class="codeRef" href="qstring.html">QString</a> <a class="code" href="classKFileMetaInfoItem.html#a4cc4ba436fdd31f3f367df2bced02eac" title="Returns the key of the item.">KFileMetaInfoItem::key</a>()<span class="keyword"> const</span>
<a name="l00166"></a>00166 <span class="keyword"></span>{
<a name="l00167"></a>00167     <span class="keywordflow">return</span> d-&gt;key;
<a name="l00168"></a>00168 }
<a name="l00169"></a>00169 
<a name="l00170"></a><a class="code" href="classKFileMetaInfoItem.html#aa3f27f5127b4105905f54842bea3f8b6">00170</a> <a class="codeRef" href="qstring.html">QString</a> <a class="code" href="classKFileMetaInfoItem.html#aa3f27f5127b4105905f54842bea3f8b6" title="Returns a translation of the key for displaying to the user.">KFileMetaInfoItem::translatedKey</a>()<span class="keyword"> const</span>
<a name="l00171"></a>00171 <span class="keyword"></span>{
<a name="l00172"></a>00172     <span class="comment">// are we a variable key?</span>
<a name="l00173"></a>00173     <span class="keywordflow">if</span> (d-&gt;mimeTypeInfo-&gt;key().isNull())
<a name="l00174"></a>00174     {
<a name="l00175"></a>00175         <span class="comment">// then try if we have luck with i18n()</span>
<a name="l00176"></a>00176         <span class="keywordflow">return</span> i18n(d-&gt;key.utf8());
<a name="l00177"></a>00177     }
<a name="l00178"></a>00178 
<a name="l00179"></a>00179     <span class="keywordflow">return</span> d-&gt;mimeTypeInfo-&gt;translatedKey();
<a name="l00180"></a>00180 }
<a name="l00181"></a>00181 
<a name="l00182"></a><a class="code" href="classKFileMetaInfoItem.html#a2032cf0c915161ad031da15018db1427">00182</a> <span class="keyword">const</span> <a class="codeRef" href="qvariant.html">QVariant</a>&amp; <a class="code" href="classKFileMetaInfoItem.html#a2032cf0c915161ad031da15018db1427" title="Returns the value of the item.">KFileMetaInfoItem::value</a>()<span class="keyword"> const</span>
<a name="l00183"></a>00183 <span class="keyword"></span>{
<a name="l00184"></a>00184     <span class="keywordflow">return</span> d-&gt;value;
<a name="l00185"></a>00185 }
<a name="l00186"></a>00186 
<a name="l00187"></a><a class="code" href="classKFileMetaInfoItem.html#ae83e40929b05a2e8d67720bca9b514ff">00187</a> <a class="codeRef" href="qstring.html">QString</a> <a class="code" href="classKFileMetaInfoItem.html#ae83e40929b05a2e8d67720bca9b514ff" title="Returns a string containing the value, if possible.">KFileMetaInfoItem::string</a>( <span class="keywordtype">bool</span> mangle )<span class="keyword"> const</span>
<a name="l00188"></a>00188 <span class="keyword"></span>{
<a name="l00189"></a>00189     <span class="keywordflow">return</span> d-&gt;mimeTypeInfo-&gt;string(d-&gt;value, mangle);
<a name="l00190"></a>00190 }
<a name="l00191"></a>00191 
<a name="l00192"></a><a class="code" href="classKFileMetaInfoItem.html#a395166bbb5df62cf3b76f7b6eb79f0e8">00192</a> QVariant::Type <a class="code" href="classKFileMetaInfoItem.html#a395166bbb5df62cf3b76f7b6eb79f0e8" title="Return the type of the item.">KFileMetaInfoItem::type</a>()<span class="keyword"> const</span>
<a name="l00193"></a>00193 <span class="keyword"></span>{
<a name="l00194"></a>00194     <span class="keywordflow">return</span> d-&gt;mimeTypeInfo-&gt;type();
<a name="l00195"></a>00195 }
<a name="l00196"></a>00196 
<a name="l00197"></a><a class="code" href="classKFileMetaInfoItem.html#adf46064274d3e201869f6d14b9bf6ea5">00197</a> uint <a class="code" href="classKFileMetaInfoItem.html#adf46064274d3e201869f6d14b9bf6ea5" title="Returns the unit for this item.">KFileMetaInfoItem::unit</a>()<span class="keyword"> const</span>
<a name="l00198"></a>00198 <span class="keyword"></span>{
<a name="l00199"></a>00199     <span class="keywordflow">return</span> d-&gt;mimeTypeInfo-&gt;unit();
<a name="l00200"></a>00200 }
<a name="l00201"></a>00201 
<a name="l00202"></a><a class="code" href="classKFileMetaInfoItem.html#a79e9841aef679989847b7ea44744bb6f">00202</a> <span class="keywordtype">bool</span> <a class="code" href="classKFileMetaInfoItem.html#a79e9841aef679989847b7ea44744bb6f" title="If you change an item, it is marked as &quot;dirty&quot;.">KFileMetaInfoItem::isModified</a>()<span class="keyword"> const</span>
<a name="l00203"></a>00203 <span class="keyword"></span>{
<a name="l00204"></a>00204     <span class="keywordflow">return</span> d-&gt;dirty;
<a name="l00205"></a>00205 }
<a name="l00206"></a>00206 
<a name="l00207"></a><a class="code" href="classKFileMetaInfoItem.html#ac2e063476cfcb77f9e06f684e32bbebb">00207</a> <a class="codeRef" href="qstring.html">QString</a> <a class="code" href="classKFileMetaInfoItem.html#ac2e063476cfcb77f9e06f684e32bbebb" title="This method returns a translated prefix to be displayed before the value.">KFileMetaInfoItem::prefix</a>()<span class="keyword"> const</span>
<a name="l00208"></a>00208 <span class="keyword"></span>{
<a name="l00209"></a>00209     <span class="keywordflow">return</span> d-&gt;mimeTypeInfo-&gt;prefix();
<a name="l00210"></a>00210 }
<a name="l00211"></a>00211 
<a name="l00212"></a><a class="code" href="classKFileMetaInfoItem.html#a04ece3239544d4fba425517fa07c1d7d">00212</a> <a class="codeRef" href="qstring.html">QString</a> <a class="code" href="classKFileMetaInfoItem.html#a04ece3239544d4fba425517fa07c1d7d" title="This method returns a translated suffix to be displayed after the value.">KFileMetaInfoItem::suffix</a>()<span class="keyword"> const</span>
<a name="l00213"></a>00213 <span class="keyword"></span>{
<a name="l00214"></a>00214     <span class="keywordflow">return</span> d-&gt;mimeTypeInfo-&gt;suffix();
<a name="l00215"></a>00215 }
<a name="l00216"></a>00216 
<a name="l00217"></a><a class="code" href="classKFileMetaInfoItem.html#aecd621d5fce7b03e51798b8be6b93769">00217</a> uint <a class="code" href="classKFileMetaInfoItem.html#aecd621d5fce7b03e51798b8be6b93769" title="Returns the hint for this item.">KFileMetaInfoItem::hint</a>()<span class="keyword"> const</span>
<a name="l00218"></a>00218 <span class="keyword"></span>{
<a name="l00219"></a>00219     <span class="keywordflow">return</span> d-&gt;mimeTypeInfo-&gt;hint();
<a name="l00220"></a>00220 }
<a name="l00221"></a>00221 
<a name="l00222"></a><a class="code" href="classKFileMetaInfoItem.html#aa9b47e34db25fea770c19338f251ab0c">00222</a> uint <a class="code" href="classKFileMetaInfoItem.html#aa9b47e34db25fea770c19338f251ab0c" title="Returns the attributes for this item.">KFileMetaInfoItem::attributes</a>()<span class="keyword"> const</span>
<a name="l00223"></a>00223 <span class="keyword"></span>{
<a name="l00224"></a>00224     <span class="keywordflow">return</span> d-&gt;mimeTypeInfo-&gt;attributes();
<a name="l00225"></a>00225 }
<a name="l00226"></a>00226 
<a name="l00227"></a><a class="code" href="classKFileMetaInfoItem.html#aa4e2b73fcb1f3bb953289fe940b5be71">00227</a> <span class="keywordtype">bool</span> <a class="code" href="classKFileMetaInfoItem.html#aa4e2b73fcb1f3bb953289fe940b5be71" title="You can query if the application can edit the item and write it back to the file with this method...">KFileMetaInfoItem::isEditable</a>()<span class="keyword"> const</span>
<a name="l00228"></a>00228 <span class="keyword"></span>{
<a name="l00229"></a>00229     <span class="keywordflow">return</span> d-&gt;mimeTypeInfo-&gt;attributes() &amp; <a class="code" href="classKFileMimeTypeInfo.html#a5d4779692b425b43302a9a113f91d59aa3d6a31c195c36a2368fbc7fa34483365" title="The value can be edited (no meaning for a group)">KFileMimeTypeInfo::Modifiable</a>;
<a name="l00230"></a>00230 }
<a name="l00231"></a>00231 
<a name="l00232"></a><a class="code" href="classKFileMetaInfoItem.html#a94bef8631db1e076ffc0b7c943efb5b7">00232</a> <span class="keywordtype">bool</span> <a class="code" href="classKFileMetaInfoItem.html#a94bef8631db1e076ffc0b7c943efb5b7" title="Return true if the item is valid, i.e.">KFileMetaInfoItem::isValid</a>()<span class="keyword"> const</span>
<a name="l00233"></a>00233 <span class="keyword"></span>{
<a name="l00234"></a>00234     <span class="comment">// We don&#39;t call makeNull here since it isn&#39;t necassery:</span>
<a name="l00235"></a>00235     <span class="comment">// If d is equal to null it means that null is initialized already.</span>
<a name="l00236"></a>00236     <span class="comment">// null is 0L when it hasn&#39;t been initialized and d is never 0L.</span>
<a name="l00237"></a>00237     <span class="keywordflow">return</span> d != Data::null;
<a name="l00238"></a>00238 }
<a name="l00239"></a>00239 
<a name="l00240"></a>00240 <span class="keywordtype">void</span> KFileMetaInfoItem::setAdded()
<a name="l00241"></a>00241 {
<a name="l00242"></a>00242     d-&gt;added = <span class="keyword">true</span>;
<a name="l00243"></a>00243 }
<a name="l00244"></a>00244 
<a name="l00245"></a>00245 <span class="keywordtype">void</span> KFileMetaInfoItem::setRemoved()
<a name="l00246"></a>00246 {
<a name="l00247"></a>00247     d-&gt;removed = <span class="keyword">true</span>;
<a name="l00248"></a>00248 }
<a name="l00249"></a>00249 
<a name="l00250"></a>00250 <span class="keywordtype">void</span> KFileMetaInfoItem::ref()
<a name="l00251"></a>00251 {
<a name="l00252"></a>00252     <span class="keywordflow">if</span> (d != Data::null) d-&gt;ref();
<a name="l00253"></a>00253 }
<a name="l00254"></a>00254 
<a name="l00255"></a>00255 <span class="keywordtype">void</span> KFileMetaInfoItem::deref()
<a name="l00256"></a>00256 {
<a name="l00257"></a>00257     <span class="comment">// We don&#39;t call makeNull here since it isn&#39;t necassery:</span>
<a name="l00258"></a>00258     <span class="comment">// If d is equal to null it means that null is initialized already.</span>
<a name="l00259"></a>00259     <span class="comment">// null is 0L when it hasn&#39;t been initialized and d is never 0L.</span>
<a name="l00260"></a>00260     <span class="keywordflow">if</span> ((d != Data::null) &amp;&amp; d-&gt;deref())
<a name="l00261"></a>00261     {
<a name="l00262"></a>00262 <span class="comment">//        kdDebug(7033) &lt;&lt; &quot;item &quot; &lt;&lt; d-&gt;key</span>
<a name="l00263"></a>00263 <span class="comment">//                      &lt;&lt; &quot; is finally deleted\n&quot;;</span>
<a name="l00264"></a>00264         <span class="keyword">delete</span> d;
<a name="l00265"></a>00265         d = 0;
<a name="l00266"></a>00266     }
<a name="l00267"></a>00267 }
<a name="l00268"></a>00268 
<a name="l00271"></a>00271 
<a name="l00272"></a>00272 <span class="comment">// shared data of a KFileMetaInfo</span>
<a name="l00273"></a>00273 <span class="keyword">class </span>KFileMetaInfo::Data : <span class="keyword">public</span> QShared
<a name="l00274"></a>00274 {
<a name="l00275"></a>00275 <span class="keyword">public</span>:
<a name="l00276"></a>00276     Data(<span class="keyword">const</span> KURL&amp; _url, uint _what)
<a name="l00277"></a>00277         : QShared(),
<a name="l00278"></a>00278           <a class="code" href="classKFileMetaInfo.html#ad418b0719f73bbefdd83c0d7a5e30e65" title="Returns the url of file.">url</a>(_url),
<a name="l00279"></a>00279           what(_what),
<a name="l00280"></a>00280           mimeTypeInfo( 0L )
<a name="l00281"></a>00281     {}
<a name="l00282"></a>00282 
<a name="l00283"></a>00283     <span class="comment">// wee use this one for the streaming operators</span>
<a name="l00284"></a>00284     Data() {};
<a name="l00285"></a>00285 
<a name="l00286"></a>00286     KURL                              <a class="code" href="classKFileMetaInfo.html#ad418b0719f73bbefdd83c0d7a5e30e65" title="Returns the url of file.">url</a>;
<a name="l00287"></a>00287     uint                              what;
<a name="l00288"></a>00288     <a class="codeRef" href="qmap.html">QMap&lt;QString, KFileMetaInfoGroup&gt;</a> <a class="code" href="classKFileMetaInfo.html#a50b0a84868c2c412d4d084a09ad8f5c7" title="Returns a list of all groups.">groups</a>;
<a name="l00289"></a>00289     <span class="keyword">const</span> <a class="code" href="classKFileMimeTypeInfo.html" title="Represents the capabilities of a KFilePlugin for a given mimetype.">KFileMimeTypeInfo</a>*          mimeTypeInfo;
<a name="l00290"></a>00290     <a class="codeRef" href="qstringlist.html">QStringList</a>                       <a class="code" href="classKFileMetaInfo.html#a6e951eeecf1eafbf4f834b5527ee40d1" title="Returns a list of removed groups.">removedGroups</a>;
<a name="l00291"></a>00291 
<a name="l00292"></a>00292     <span class="keyword">static</span> Data* null;
<a name="l00293"></a>00293     <span class="keyword">static</span> Data* makeNull();
<a name="l00294"></a>00294 
<a name="l00295"></a>00295 };
<a name="l00296"></a>00296 
<a name="l00297"></a><a class="code" href="classKFileMetaInfo.html#a6aa2cea76a7ffa4a598754155b06fa53">00297</a> <a class="code" href="classKFileMetaInfo.html#a8e666f840fbad344cab5e280e62043f6" title="Default constructor.">KFileMetaInfo::KFileMetaInfo</a>( <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>&amp; path, <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>&amp; mimeType,
<a name="l00298"></a>00298                               uint what )
<a name="l00299"></a>00299 {
<a name="l00300"></a>00300     KURL u;
<a name="l00301"></a>00301 
<a name="l00302"></a>00302     u.setPath(path);
<a name="l00303"></a>00303     init(u, mimeType, what);
<a name="l00304"></a>00304 }
<a name="l00305"></a>00305 
<a name="l00306"></a><a class="code" href="classKFileMetaInfo.html#ac21d70d75206a487cf9f51e3f139c8fc">00306</a> <a class="code" href="classKFileMetaInfo.html#a8e666f840fbad344cab5e280e62043f6" title="Default constructor.">KFileMetaInfo::KFileMetaInfo</a>( <span class="keyword">const</span> KURL&amp; url, <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>&amp; mimeType,
<a name="l00307"></a>00307                               uint what )
<a name="l00308"></a>00308 {
<a name="l00309"></a>00309     init(url, mimeType, what);
<a name="l00310"></a>00310 }
<a name="l00311"></a>00311 
<a name="l00312"></a>00312 <span class="keywordtype">void</span> KFileMetaInfo::init( <span class="keyword">const</span> KURL&amp; url, <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>&amp; mimeType,
<a name="l00313"></a>00313                           uint what )
<a name="l00314"></a>00314 {
<a name="l00315"></a>00315     d = <span class="keyword">new</span> Data( url, what );
<a name="l00316"></a>00316 
<a name="l00317"></a>00317     <a class="codeRef" href="qstring.html">QString</a> mT;
<a name="l00318"></a>00318     <span class="keywordflow">if</span> (mimeType.<a class="codeRef" href="qstring.html#isEmpty">isEmpty</a>())
<a name="l00319"></a>00319         mT = <a class="code" href="classKMimeType.html#a19c6563574d22a7395c4686c06e1dec9" title="Finds a KMimeType with the given _url.">KMimeType::findByURL</a>(url)-&gt;name();
<a name="l00320"></a>00320     <span class="keywordflow">else</span>
<a name="l00321"></a>00321         mT = <a class="code" href="classKFileMetaInfo.html#aa66beda41a4f837b8129e9ad5f3fe6d0" title="Returns the mime type of file.">mimeType</a>;
<a name="l00322"></a>00322 
<a name="l00323"></a>00323     <span class="comment">// let&#39;s &quot;share our property&quot;</span>
<a name="l00324"></a>00324     <a class="code" href="classKFileMetaInfo.html" title="Meta Information about a file.">KFileMetaInfo</a> <a class="code" href="classKFileMetaInfo.html#a49e8498204ac9b16d489a53a3d12e783" title="Returns the KFileMetaInfoItem with the given key.">item</a>(*<span class="keyword">this</span>);
<a name="l00325"></a>00325 
<a name="l00326"></a>00326     <span class="comment">//kdDebug() &lt;&lt; k_funcinfo &lt;&lt; mT &lt;&lt; &quot; &quot; &lt;&lt; url &lt;&lt; endl;</span>
<a name="l00327"></a>00327 
<a name="l00328"></a>00328     d-&gt;mimeTypeInfo = KFileMetaInfoProvider::self()-&gt;mimeTypeInfo( mT, url.protocol() );
<a name="l00329"></a>00329     <span class="keywordflow">if</span> ( d-&gt;mimeTypeInfo )
<a name="l00330"></a>00330     {
<a name="l00331"></a>00331         <span class="comment">//kdDebug(7033) &lt;&lt; &quot;Found mimetype info for &quot; &lt;&lt; mT /* or protocol*/ &lt;&lt; endl;</span>
<a name="l00332"></a>00332         <a class="code" href="classKFilePlugin.html" title="Base class for a meta information plugin.">KFilePlugin</a> *p = <a class="code" href="classKFileMetaInfo.html#a63b17f312fcf7a8d6246e1e403ecc0fb">plugin</a>();
<a name="l00333"></a>00333         Q_ASSERT( p );
<a name="l00334"></a>00334         <span class="keywordflow">if</span> ( p &amp;&amp; !p-&gt;<a class="code" href="classKFilePlugin.html#ad6293fac3c4386e077c7a5440be5f9ed" title="Read the info from the file in this method and insert it into the provided KFileMetaInfo object...">readInfo</a>( <a class="code" href="classKFileMetaInfo.html#a49e8498204ac9b16d489a53a3d12e783" title="Returns the KFileMetaInfoItem with the given key.">item</a>, what) )
<a name="l00335"></a>00335         {
<a name="l00336"></a>00336             deref();
<a name="l00337"></a>00337             d = Data::makeNull();
<a name="l00338"></a>00338         }
<a name="l00339"></a>00339     }
<a name="l00340"></a>00340     <span class="keywordflow">else</span>
<a name="l00341"></a>00341     {
<a name="l00342"></a>00342 <span class="comment">//        kdDebug(7033) &lt;&lt; &quot;No mimetype info for &quot; &lt;&lt; mimeType &lt;&lt; endl;</span>
<a name="l00343"></a>00343         deref();
<a name="l00344"></a>00344         d = Data::makeNull();
<a name="l00345"></a>00345     }
<a name="l00346"></a>00346 }
<a name="l00347"></a>00347 
<a name="l00348"></a><a class="code" href="classKFileMetaInfo.html#aca240a77d51446460145ae5ff5c6ba30">00348</a> <a class="code" href="classKFileMetaInfo.html#a8e666f840fbad344cab5e280e62043f6" title="Default constructor.">KFileMetaInfo::KFileMetaInfo</a>( <span class="keyword">const</span> <a class="code" href="classKFileMetaInfo.html" title="Meta Information about a file.">KFileMetaInfo</a>&amp; original )
<a name="l00349"></a>00349 {
<a name="l00350"></a>00350     <span class="comment">// operator= does everything that&#39;s necessary</span>
<a name="l00351"></a>00351     d = Data::makeNull();
<a name="l00352"></a>00352     *<span class="keyword">this</span> = original;
<a name="l00353"></a>00353 }
<a name="l00354"></a>00354 
<a name="l00355"></a><a class="code" href="classKFileMetaInfo.html#a8e666f840fbad344cab5e280e62043f6">00355</a> <a class="code" href="classKFileMetaInfo.html#a8e666f840fbad344cab5e280e62043f6" title="Default constructor.">KFileMetaInfo::KFileMetaInfo</a>()
<a name="l00356"></a>00356 {
<a name="l00357"></a>00357     d = Data::makeNull();
<a name="l00358"></a>00358 }
<a name="l00359"></a>00359 
<a name="l00360"></a>00360 KFileMetaInfo::~KFileMetaInfo()
<a name="l00361"></a>00361 {
<a name="l00362"></a>00362     deref();
<a name="l00363"></a>00363 }
<a name="l00364"></a>00364 
<a name="l00365"></a><a class="code" href="classKFileMetaInfo.html#aaf1b109f4fe24c1dc0598234c59f59ce">00365</a> <a class="codeRef" href="qstringlist.html">QStringList</a> <a class="code" href="classKFileMetaInfo.html#aaf1b109f4fe24c1dc0598234c59f59ce" title="Returns a list of all supported groups.">KFileMetaInfo::supportedGroups</a>()<span class="keyword"> const</span>
<a name="l00366"></a>00366 <span class="keyword"></span>{
<a name="l00367"></a>00367     assert(<a class="code" href="classKFileMetaInfo.html#a7fbb3ea4fc85133d4bd0534f7c684b1e" title="Returns true if the item is valid, i.e.">isValid</a>());
<a name="l00368"></a>00368     <span class="keywordflow">return</span> d-&gt;mimeTypeInfo-&gt;supportedGroups();
<a name="l00369"></a>00369 }
<a name="l00370"></a>00370 
<a name="l00371"></a><a class="code" href="classKFileMetaInfo.html#aeb4a103fc5808a71a0458105112b5e82">00371</a> <a class="codeRef" href="qstringlist.html">QStringList</a> <a class="code" href="classKFileMetaInfo.html#aeb4a103fc5808a71a0458105112b5e82" title="Returns a list of supported keys.">KFileMetaInfo::supportedKeys</a>()<span class="keyword"> const</span>
<a name="l00372"></a>00372 <span class="keyword"></span>{
<a name="l00373"></a>00373     assert(<a class="code" href="classKFileMetaInfo.html#a7fbb3ea4fc85133d4bd0534f7c684b1e" title="Returns true if the item is valid, i.e.">isValid</a>());
<a name="l00374"></a>00374     <span class="keywordflow">return</span> d-&gt;mimeTypeInfo-&gt;supportedKeys();
<a name="l00375"></a>00375 }
<a name="l00376"></a>00376 
<a name="l00377"></a><a class="code" href="classKFileMetaInfo.html#a50b0a84868c2c412d4d084a09ad8f5c7">00377</a> <a class="codeRef" href="qstringlist.html">QStringList</a> <a class="code" href="classKFileMetaInfo.html#a50b0a84868c2c412d4d084a09ad8f5c7" title="Returns a list of all groups.">KFileMetaInfo::groups</a>()<span class="keyword"> const</span>
<a name="l00378"></a>00378 <span class="keyword"></span>{
<a name="l00379"></a>00379     <a class="codeRef" href="qstringlist.html">QStringList</a> list;
<a name="l00380"></a>00380     <a class="codeRef" href="qmapconstiterator.html">QMapConstIterator&lt;QString, KFileMetaInfoGroup&gt;</a> it = d-&gt;groups.begin();
<a name="l00381"></a>00381     <span class="keywordflow">for</span> ( ; it != d-&gt;groups.end(); ++it )
<a name="l00382"></a>00382         list += (*it).name();
<a name="l00383"></a>00383 
<a name="l00384"></a>00384     <span class="keywordflow">return</span> list;
<a name="l00385"></a>00385 }
<a name="l00386"></a>00386 
<a name="l00387"></a><a class="code" href="classKFileMetaInfo.html#ac8b0d2ad5ffe9284f5515f9b55ca9a68">00387</a> <a class="codeRef" href="qstringlist.html">QStringList</a> <a class="code" href="classKFileMetaInfo.html#ac8b0d2ad5ffe9284f5515f9b55ca9a68" title="Returns the list of groups that you can add or remove from the file.">KFileMetaInfo::editableGroups</a>()<span class="keyword"> const</span>
<a name="l00388"></a>00388 <span class="keyword"></span>{
<a name="l00389"></a>00389     <a class="codeRef" href="qstringlist.html">QStringList</a> list;
<a name="l00390"></a>00390     <a class="codeRef" href="qstringlist.html">QStringList</a> supported = <a class="code" href="classKFileMetaInfo.html#aaf1b109f4fe24c1dc0598234c59f59ce" title="Returns a list of all supported groups.">supportedGroups</a>();
<a name="l00391"></a>00391     QStringList::ConstIterator it = supported.begin();
<a name="l00392"></a>00392     <span class="keywordflow">for</span> ( ; it != supported.end(); ++it ) {
<a name="l00393"></a>00393         <span class="keyword">const</span> <a class="code" href="classKFileMimeTypeInfo_1_1GroupInfo.html" title="Information about a meta information group.">KFileMimeTypeInfo::GroupInfo</a> * groupInfo = d-&gt;mimeTypeInfo-&gt;groupInfo( *it );
<a name="l00394"></a>00394         <span class="keywordflow">if</span> ( groupInfo &amp;&amp; groupInfo-&gt;<a class="code" href="classKFileMimeTypeInfo_1_1GroupInfo.html#ab068d0f0587e7ec439289f7bb339d38f" title="Get the attributes of this group (see Attributes)">attributes</a>() &amp;
<a name="l00395"></a>00395              (<a class="code" href="classKFileMimeTypeInfo.html#a5d4779692b425b43302a9a113f91d59aadd6dc584228b4b24a9fcc23f93ffa8f5" title="The item or group can be added by a user.">KFileMimeTypeInfo::Addable</a> | <a class="code" href="classKFileMimeTypeInfo.html#a5d4779692b425b43302a9a113f91d59aa2f287a0516bbeb007422bbe06142ed38" title="It can be removed.">KFileMimeTypeInfo::Removable</a>) )
<a name="l00396"></a>00396             list.append( *it );
<a name="l00397"></a>00397     }
<a name="l00398"></a>00398 
<a name="l00399"></a>00399     <span class="keywordflow">return</span> list;
<a name="l00400"></a>00400 }
<a name="l00401"></a>00401 
<a name="l00402"></a><a class="code" href="classKFileMetaInfo.html#aaa60c17a8eb2f7a90383ef87330dab88">00402</a> <a class="codeRef" href="qstringlist.html">QStringList</a> <a class="code" href="classKFileMetaInfo.html#aaa60c17a8eb2f7a90383ef87330dab88" title="Returns a list of the preferred groups.">KFileMetaInfo::preferredGroups</a>()<span class="keyword"> const</span>
<a name="l00403"></a>00403 <span class="keyword"></span>{
<a name="l00404"></a>00404     assert(<a class="code" href="classKFileMetaInfo.html#a7fbb3ea4fc85133d4bd0534f7c684b1e" title="Returns true if the item is valid, i.e.">isValid</a>());
<a name="l00405"></a>00405     <a class="codeRef" href="qstringlist.html">QStringList</a> list = <a class="code" href="classKFileMetaInfo.html#a50b0a84868c2c412d4d084a09ad8f5c7" title="Returns a list of all groups.">groups</a>();
<a name="l00406"></a>00406     <a class="codeRef" href="qstringlist.html">QStringList</a> newlist;
<a name="l00407"></a>00407     <a class="codeRef" href="qstringlist.html">QStringList</a> preferred = d-&gt;mimeTypeInfo-&gt;preferredGroups();
<a name="l00408"></a>00408     QStringList::Iterator pref;
<a name="l00409"></a>00409 
<a name="l00410"></a>00410     <span class="comment">// move all keys from the preferred groups that are in our list to a new list</span>
<a name="l00411"></a>00411     <span class="keywordflow">for</span> ( pref = preferred.begin(); pref != preferred.end(); ++pref )
<a name="l00412"></a>00412     {
<a name="l00413"></a>00413         QStringList::Iterator <a class="code" href="classKFileMetaInfo.html#af98d53e2a06af8fd2959ab138f8d3817" title="Returns the KFileMetaInfoGroup with the given key.">group</a> = list.find(*pref);
<a name="l00414"></a>00414         <span class="keywordflow">if</span> ( group != list.end() )
<a name="l00415"></a>00415         {
<a name="l00416"></a>00416              newlist.append( *group );
<a name="l00417"></a>00417              list.remove(group);
<a name="l00418"></a>00418         }
<a name="l00419"></a>00419     }
<a name="l00420"></a>00420 
<a name="l00421"></a>00421     <span class="comment">// now the old list only contains the non-preferred items, so we</span>
<a name="l00422"></a>00422     <span class="comment">// add the remaining ones to newlist</span>
<a name="l00423"></a>00423     newlist += list;
<a name="l00424"></a>00424 
<a name="l00425"></a>00425     <span class="keywordflow">return</span> newlist;
<a name="l00426"></a>00426 }
<a name="l00427"></a>00427 
<a name="l00428"></a><a class="code" href="classKFileMetaInfo.html#ae8a67e83cb2452b97bd877daf113e948">00428</a> <a class="codeRef" href="qstringlist.html">QStringList</a> <a class="code" href="classKFileMetaInfo.html#ae8a67e83cb2452b97bd877daf113e948" title="Returns a list of all preferred keys.">KFileMetaInfo::preferredKeys</a>()<span class="keyword"> const</span>
<a name="l00429"></a>00429 <span class="keyword"></span>{
<a name="l00430"></a>00430     <a class="codeRef" href="qstringlist.html">QStringList</a> newlist;
<a name="l00431"></a>00431 
<a name="l00432"></a>00432     <a class="codeRef" href="qstringlist.html">QStringList</a> list = <a class="code" href="classKFileMetaInfo.html#aaa60c17a8eb2f7a90383ef87330dab88" title="Returns a list of the preferred groups.">preferredGroups</a>();
<a name="l00433"></a>00433     <span class="keywordflow">for</span> (QStringList::Iterator git = list.begin(); git != list.end(); ++git)
<a name="l00434"></a>00434     {
<a name="l00435"></a>00435         newlist += d-&gt;groups[*git].preferredKeys();
<a name="l00436"></a>00436     }
<a name="l00437"></a>00437 
<a name="l00438"></a>00438     <span class="keywordflow">return</span> newlist;
<a name="l00439"></a>00439 }
<a name="l00440"></a>00440 
<a name="l00441"></a><a class="code" href="classKFileMetaInfo.html#af98d53e2a06af8fd2959ab138f8d3817">00441</a> <a class="code" href="classKFileMetaInfoGroup.html" title="A group of meta information items about a file.">KFileMetaInfoGroup</a> <a class="code" href="classKFileMetaInfo.html#af98d53e2a06af8fd2959ab138f8d3817" title="Returns the KFileMetaInfoGroup with the given key.">KFileMetaInfo::group</a>(<span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>&amp; key)<span class="keyword"> const</span>
<a name="l00442"></a>00442 <span class="keyword"></span>{
<a name="l00443"></a>00443     <a class="codeRef" href="qmapiterator.html">QMapIterator&lt;QString,KFileMetaInfoGroup&gt;</a> it = d-&gt;groups.find( key );
<a name="l00444"></a>00444     <span class="keywordflow">if</span> ( it != d-&gt;groups.end() )
<a name="l00445"></a>00445         <span class="keywordflow">return</span> it.<a class="codeRef" href="qmapiterator.html#data">data</a>();
<a name="l00446"></a>00446     <span class="keywordflow">else</span>
<a name="l00447"></a>00447         <span class="keywordflow">return</span> <a class="code" href="classKFileMetaInfoGroup.html" title="A group of meta information items about a file.">KFileMetaInfoGroup</a>();
<a name="l00448"></a>00448 }
<a name="l00449"></a>00449 
<a name="l00450"></a><a class="code" href="classKFileMetaInfo.html#a4c22434c1a5ace0e4c8b576b9d64f0a1">00450</a> <span class="keywordtype">bool</span> <a class="code" href="classKFileMetaInfo.html#a4c22434c1a5ace0e4c8b576b9d64f0a1" title="Try to add the specified group.">KFileMetaInfo::addGroup</a>( <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>&amp; name )
<a name="l00451"></a>00451 {
<a name="l00452"></a>00452     assert(<a class="code" href="classKFileMetaInfo.html#a7fbb3ea4fc85133d4bd0534f7c684b1e" title="Returns true if the item is valid, i.e.">isValid</a>());
<a name="l00453"></a>00453     <span class="keywordflow">if</span> ( d-&gt;mimeTypeInfo-&gt;supportedGroups().contains(name) &amp;&amp;
<a name="l00454"></a>00454          ! d-&gt;groups.contains(name) )
<a name="l00455"></a>00455     {
<a name="l00456"></a>00456         <a class="code" href="classKFileMetaInfoGroup.html" title="A group of meta information items about a file.">KFileMetaInfoGroup</a> <a class="code" href="classKFileMetaInfo.html#af98d53e2a06af8fd2959ab138f8d3817" title="Returns the KFileMetaInfoGroup with the given key.">group</a>( name, d-&gt;mimeTypeInfo );
<a name="l00457"></a>00457 
<a name="l00458"></a>00458         <span class="comment">// add all the items that can&#39;t be added by the user later</span>
<a name="l00459"></a>00459         <span class="keyword">const</span> <a class="code" href="classKFileMimeTypeInfo_1_1GroupInfo.html" title="Information about a meta information group.">KFileMimeTypeInfo::GroupInfo</a>* ginfo = d-&gt;mimeTypeInfo-&gt;groupInfo(name);
<a name="l00460"></a>00460         Q_ASSERT(ginfo);
<a name="l00461"></a>00461         <span class="keywordflow">if</span> (!ginfo) <span class="keywordflow">return</span> <span class="keyword">false</span>;
<a name="l00462"></a>00462 
<a name="l00463"></a>00463         <a class="codeRef" href="qstringlist.html">QStringList</a> keys = ginfo-&gt;<a class="code" href="classKFileMimeTypeInfo_1_1GroupInfo.html#ad1e96645fcd60435c8e090f79839d7f3" title="Use this method to get a list of keys in the specified group that the plugin knows about...">supportedKeys</a>();
<a name="l00464"></a>00464         <span class="keywordflow">for</span> (QStringList::Iterator it = keys.begin(); it != keys.end(); ++it)
<a name="l00465"></a>00465         {
<a name="l00466"></a>00466             <span class="keyword">const</span> <a class="code" href="classKFileMimeTypeInfo_1_1ItemInfo.html" title="This is the class for one item of a KFileMimeTypeInfo.">KFileMimeTypeInfo::ItemInfo</a>* iteminfo = ginfo-&gt;<a class="code" href="classKFileMimeTypeInfo_1_1GroupInfo.html#a2c989d3f558e03095b16b2d98847dc2b" title="A group object can contain several item objects (of which you can get the names with supportedKeys() ...">itemInfo</a>(*it);
<a name="l00467"></a>00467             Q_ASSERT(ginfo);
<a name="l00468"></a>00468             <span class="keywordflow">if</span> (!iteminfo) <span class="keywordflow">return</span> <span class="keyword">false</span>;
<a name="l00469"></a>00469 
<a name="l00470"></a>00470             <span class="keywordflow">if</span> ( !(iteminfo-&gt;<a class="code" href="classKFileMimeTypeInfo_1_1ItemInfo.html#a3237c6bed09a9a0edc8314231685322a" title="Return the attributes of the item.">attributes</a>() &amp; <a class="code" href="classKFileMimeTypeInfo.html#a5d4779692b425b43302a9a113f91d59aadd6dc584228b4b24a9fcc23f93ffa8f5" title="The item or group can be added by a user.">KFileMimeTypeInfo::Addable</a>) &amp;&amp;
<a name="l00471"></a>00471                   (iteminfo-&gt;<a class="code" href="classKFileMimeTypeInfo_1_1ItemInfo.html#a3237c6bed09a9a0edc8314231685322a" title="Return the attributes of the item.">attributes</a>() &amp; <a class="code" href="classKFileMimeTypeInfo.html#a5d4779692b425b43302a9a113f91d59aa3d6a31c195c36a2368fbc7fa34483365" title="The value can be edited (no meaning for a group)">KFileMimeTypeInfo::Modifiable</a>))
<a name="l00472"></a>00472             {
<a name="l00473"></a>00473                 <span class="comment">// append it now or never</span>
<a name="l00474"></a>00474                 group.appendItem(iteminfo-&gt;<a class="code" href="classKFileMimeTypeInfo_1_1ItemInfo.html#ad691d8dd5908a9ef8cde85e20c22df92" title="Returns the name of the item.">key</a>(), <a class="codeRef" href="qvariant.html">QVariant</a>());
<a name="l00475"></a>00475             }
<a name="l00476"></a>00476 
<a name="l00477"></a>00477         }
<a name="l00478"></a>00478 
<a name="l00479"></a>00479         d-&gt;groups.insert(name, group);
<a name="l00480"></a>00480         group.setAdded();
<a name="l00481"></a>00481         <span class="keywordflow">return</span> <span class="keyword">true</span>;
<a name="l00482"></a>00482     }
<a name="l00483"></a>00483 
<a name="l00484"></a>00484     <span class="keywordflow">return</span> <span class="keyword">false</span>;
<a name="l00485"></a>00485 }
<a name="l00486"></a>00486 
<a name="l00487"></a><a class="code" href="classKFileMetaInfo.html#a6e1ecd83853eea8521bf592000b59b90">00487</a> <span class="keywordtype">bool</span> <a class="code" href="classKFileMetaInfo.html#a6e1ecd83853eea8521bf592000b59b90" title="Remove the specified group.">KFileMetaInfo::removeGroup</a>( <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>&amp; name )
<a name="l00488"></a>00488 {
<a name="l00489"></a>00489     <a class="codeRef" href="qmapiterator.html">QMapIterator&lt;QString, KFileMetaInfoGroup&gt;</a> it = d-&gt;groups.find(name);
<a name="l00490"></a>00490     <span class="keywordflow">if</span> ( (it==d-&gt;groups.end()) ||
<a name="l00491"></a>00491         !((*it).attributes() &amp; <a class="code" href="classKFileMimeTypeInfo.html#a5d4779692b425b43302a9a113f91d59aa2f287a0516bbeb007422bbe06142ed38" title="It can be removed.">KFileMimeTypeInfo::Removable</a>))
<a name="l00492"></a>00492         <span class="keywordflow">return</span> <span class="keyword">false</span>;
<a name="l00493"></a>00493 
<a name="l00494"></a>00494     d-&gt;groups.remove(it);
<a name="l00495"></a>00495     d-&gt;removedGroups.append(name);
<a name="l00496"></a>00496     <span class="keywordflow">return</span> <span class="keyword">true</span>;
<a name="l00497"></a>00497 }
<a name="l00498"></a>00498 
<a name="l00499"></a><a class="code" href="classKFileMetaInfo.html#a6e951eeecf1eafbf4f834b5527ee40d1">00499</a> <a class="codeRef" href="qstringlist.html">QStringList</a> <a class="code" href="classKFileMetaInfo.html#a6e951eeecf1eafbf4f834b5527ee40d1" title="Returns a list of removed groups.">KFileMetaInfo::removedGroups</a>()
<a name="l00500"></a>00500 {
<a name="l00501"></a>00501     <span class="keywordflow">return</span> d-&gt;removedGroups;
<a name="l00502"></a>00502 }
<a name="l00503"></a>00503 
<a name="l00504"></a><a class="code" href="classKFileMetaInfo.html#abe5481cddeb00bb227dbccb01e97744e">00504</a> <span class="keyword">const</span> <a class="code" href="classKFileMetaInfo.html" title="Meta Information about a file.">KFileMetaInfo</a>&amp; <a class="code" href="classKFileMetaInfo.html#abe5481cddeb00bb227dbccb01e97744e" title="The assignment operator, so you can do e.g.">KFileMetaInfo::operator= </a>(<span class="keyword">const</span> <a class="code" href="classKFileMetaInfo.html" title="Meta Information about a file.">KFileMetaInfo</a>&amp; info )
<a name="l00505"></a>00505 {
<a name="l00506"></a>00506     <span class="keywordflow">if</span> (d != info.d)
<a name="l00507"></a>00507     {
<a name="l00508"></a>00508         deref();
<a name="l00509"></a>00509         <span class="comment">// first deref the old one</span>
<a name="l00510"></a>00510         d = info.d;
<a name="l00511"></a>00511         <span class="comment">// and now ref the new one</span>
<a name="l00512"></a>00512         ref();
<a name="l00513"></a>00513     }
<a name="l00514"></a>00514     <span class="keywordflow">return</span> *<span class="keyword">this</span>;
<a name="l00515"></a>00515 }
<a name="l00516"></a>00516 
<a name="l00517"></a><a class="code" href="classKFileMetaInfo.html#a7fbb3ea4fc85133d4bd0534f7c684b1e">00517</a> <span class="keywordtype">bool</span> <a class="code" href="classKFileMetaInfo.html#a7fbb3ea4fc85133d4bd0534f7c684b1e" title="Returns true if the item is valid, i.e.">KFileMetaInfo::isValid</a>()<span class="keyword"> const</span>
<a name="l00518"></a>00518 <span class="keyword"></span>{
<a name="l00519"></a>00519     <span class="comment">// We don&#39;t call makeNull here since it isn&#39;t necassery, see deref()</span>
<a name="l00520"></a>00520     <span class="keywordflow">return</span> d != Data::null;
<a name="l00521"></a>00521 }
<a name="l00522"></a>00522 
<a name="l00523"></a><a class="code" href="classKFileMetaInfo.html#a8ac447c44bbe39bba51362428006aa74">00523</a> <span class="keywordtype">bool</span> <a class="code" href="classKFileMetaInfo.html#a8ac447c44bbe39bba51362428006aa74" title="Returns false if the object contains data, true if it&#39;s empty.">KFileMetaInfo::isEmpty</a>()<span class="keyword"> const</span>
<a name="l00524"></a>00524 <span class="keyword"></span>{
<a name="l00525"></a>00525     <span class="keywordflow">for</span> (<a class="codeRef" href="qmapiterator.html">QMapIterator&lt;QString, KFileMetaInfoGroup&gt;</a> it = d-&gt;groups.begin();
<a name="l00526"></a>00526          it!=d-&gt;groups.end(); ++it)
<a name="l00527"></a>00527         <span class="keywordflow">if</span> (!(*it).isEmpty())
<a name="l00528"></a>00528             <span class="keywordflow">return</span> <span class="keyword">false</span>;
<a name="l00529"></a>00529     <span class="keywordflow">return</span> <span class="keyword">true</span>;
<a name="l00530"></a>00530 }
<a name="l00531"></a>00531 
<a name="l00532"></a><a class="code" href="classKFileMetaInfo.html#a3cc2af17f82ab4f5254b0ca6c53a65e7">00532</a> <span class="keywordtype">bool</span> <a class="code" href="classKFileMetaInfo.html#a3cc2af17f82ab4f5254b0ca6c53a65e7" title="This method writes all pending changes of the meta info back to the file.">KFileMetaInfo::applyChanges</a>()
<a name="l00533"></a>00533 {
<a name="l00534"></a>00534     <span class="keywordflow">return</span> <a class="code" href="classKFileMetaInfo.html#a3cc2af17f82ab4f5254b0ca6c53a65e7" title="This method writes all pending changes of the meta info back to the file.">applyChanges</a>( <a class="code" href="classKFileMetaInfo.html#af91e110c26a3165bbd43db5017048100" title="Returns the path of file - or QString::null if file is non-local.">path</a>() );
<a name="l00535"></a>00535 }
<a name="l00536"></a>00536 
<a name="l00537"></a><a class="code" href="classKFileMetaInfo.html#a3cdb83c1f59e65dfe483a4fcf26ce126">00537</a> <span class="keywordtype">bool</span> <a class="code" href="classKFileMetaInfo.html#a3cc2af17f82ab4f5254b0ca6c53a65e7" title="This method writes all pending changes of the meta info back to the file.">KFileMetaInfo::applyChanges</a>( <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>&amp; path )
<a name="l00538"></a>00538 {
<a name="l00539"></a>00539     <span class="keywordtype">bool</span> doit = <span class="keyword">false</span>;
<a name="l00540"></a>00540 
<a name="l00541"></a>00541 <span class="comment">//    kdDebug(7033) &lt;&lt; &quot;KFileMetaInfo::applyChanges()\n&quot;;</span>
<a name="l00542"></a>00542 
<a name="l00543"></a>00543     <span class="comment">// look up if we need to write to the file</span>
<a name="l00544"></a>00544     <a class="codeRef" href="qmapconstiterator.html">QMapConstIterator&lt;QString, KFileMetaInfoGroup&gt;</a> it;
<a name="l00545"></a>00545     <span class="keywordflow">for</span> (it = d-&gt;groups.begin(); it!=d-&gt;groups.end() &amp;&amp; !doit; ++it)
<a name="l00546"></a>00546     {
<a name="l00547"></a>00547         <span class="keywordflow">if</span> ( (*it).isModified() )
<a name="l00548"></a>00548             doit = <span class="keyword">true</span>;
<a name="l00549"></a>00549 
<a name="l00550"></a>00550         <span class="keywordflow">else</span>
<a name="l00551"></a>00551         {
<a name="l00552"></a>00552             <a class="codeRef" href="qstringlist.html">QStringList</a> keys = it.<a class="codeRef" href="qmapconstiterator.html#data">data</a>().keys();
<a name="l00553"></a>00553             <span class="keywordflow">for</span> (QStringList::Iterator it2 = keys.begin(); it2!=keys.end(); ++it2)
<a name="l00554"></a>00554             {
<a name="l00555"></a>00555                 <span class="keywordflow">if</span> ( (*it)[*it2].isModified() )
<a name="l00556"></a>00556                 {
<a name="l00557"></a>00557                     doit = <span class="keyword">true</span>;
<a name="l00558"></a>00558                     <span class="keywordflow">break</span>;
<a name="l00559"></a>00559                 }
<a name="l00560"></a>00560             }
<a name="l00561"></a>00561         }
<a name="l00562"></a>00562     }
<a name="l00563"></a>00563 
<a name="l00564"></a>00564     <span class="keywordflow">if</span> (!doit)
<a name="l00565"></a>00565     {
<a name="l00566"></a>00566         kdDebug(7033) &lt;&lt; <span class="stringliteral">&quot;Don&#39;t need to write, nothing changed\n&quot;</span>;
<a name="l00567"></a>00567         <span class="keywordflow">return</span> <span class="keyword">true</span>;
<a name="l00568"></a>00568     }
<a name="l00569"></a>00569 
<a name="l00570"></a>00570     <a class="code" href="classKFilePlugin.html" title="Base class for a meta information plugin.">KFilePlugin</a>* p = <a class="code" href="classKFileMetaInfo.html#a63b17f312fcf7a8d6246e1e403ecc0fb">plugin</a>();
<a name="l00571"></a>00571     <span class="keywordflow">if</span> (!p) <span class="keywordflow">return</span> <span class="keyword">false</span>;
<a name="l00572"></a>00572 
<a name="l00573"></a>00573 <span class="comment">//    kdDebug(7033) &lt;&lt; &quot;Ok, trying to write the info\n&quot;;</span>
<a name="l00574"></a>00574 
<a name="l00575"></a>00575     KURL savedURL = <a class="code" href="classKFileMetaInfo.html#ad418b0719f73bbefdd83c0d7a5e30e65" title="Returns the url of file.">url</a>();
<a name="l00576"></a>00576     d-&gt;url = KURL();
<a name="l00577"></a>00577     d-&gt;url.setPath( path );
<a name="l00578"></a>00578     
<a name="l00579"></a>00579     <span class="keywordtype">bool</span> ret = p-&gt;<a class="code" href="classKFilePlugin.html#add487cfb38b9449bcd9cf7c26e6fb572" title="Similar to the readInfo() but for writing the info back to the file.">writeInfo</a>(*<span class="keyword">this</span>);
<a name="l00580"></a>00580     
<a name="l00581"></a>00581     d-&gt;url = savedURL;
<a name="l00582"></a>00582     <span class="keywordflow">return</span> ret;
<a name="l00583"></a>00583 }
<a name="l00584"></a>00584 
<a name="l00585"></a><a class="code" href="classKFileMetaInfo.html#a63b17f312fcf7a8d6246e1e403ecc0fb">00585</a> <a class="code" href="classKFilePlugin.html" title="Base class for a meta information plugin.">KFilePlugin</a> * <span class="keyword">const</span> <a class="code" href="classKFileMetaInfo.html#a63b17f312fcf7a8d6246e1e403ecc0fb">KFileMetaInfo::plugin</a>()<span class="keyword"> const</span>
<a name="l00586"></a>00586 <span class="keyword"></span>{
<a name="l00587"></a>00587     assert(<a class="code" href="classKFileMetaInfo.html#a7fbb3ea4fc85133d4bd0534f7c684b1e" title="Returns true if the item is valid, i.e.">isValid</a>());
<a name="l00588"></a>00588     KFileMetaInfoProvider* prov = KFileMetaInfoProvider::self();
<a name="l00589"></a>00589     <span class="keywordflow">return</span> prov-&gt;plugin( d-&gt;mimeTypeInfo-&gt;mimeType(), d-&gt;url.protocol() );
<a name="l00590"></a>00590 }
<a name="l00591"></a>00591 
<a name="l00592"></a><a class="code" href="classKFileMetaInfo.html#aa66beda41a4f837b8129e9ad5f3fe6d0">00592</a> <a class="codeRef" href="qstring.html">QString</a> <a class="code" href="classKFileMetaInfo.html#aa66beda41a4f837b8129e9ad5f3fe6d0" title="Returns the mime type of file.">KFileMetaInfo::mimeType</a>()<span class="keyword"> const</span>
<a name="l00593"></a>00593 <span class="keyword"></span>{
<a name="l00594"></a>00594     assert(<a class="code" href="classKFileMetaInfo.html#a7fbb3ea4fc85133d4bd0534f7c684b1e" title="Returns true if the item is valid, i.e.">isValid</a>());
<a name="l00595"></a>00595     <span class="keywordflow">return</span> d-&gt;mimeTypeInfo-&gt;mimeType();
<a name="l00596"></a>00596 }
<a name="l00597"></a>00597 
<a name="l00598"></a><a class="code" href="classKFileMetaInfo.html#aa8aee1669e0a6e203e2cc9113f10fce2">00598</a> <span class="keywordtype">bool</span> <a class="code" href="classKFileMetaInfo.html#aa8aee1669e0a6e203e2cc9113f10fce2" title="Checks whether an item with the given key exists.">KFileMetaInfo::contains</a>(<span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>&amp; key)<span class="keyword"> const</span>
<a name="l00599"></a>00599 <span class="keyword"></span>{
<a name="l00600"></a>00600     <a class="codeRef" href="qstringlist.html">QStringList</a> glist = <a class="code" href="classKFileMetaInfo.html#a50b0a84868c2c412d4d084a09ad8f5c7" title="Returns a list of all groups.">groups</a>();
<a name="l00601"></a>00601     <span class="keywordflow">for</span> (QStringList::Iterator it = glist.begin(); it != glist.end(); ++it)
<a name="l00602"></a>00602     {
<a name="l00603"></a>00603         <a class="code" href="classKFileMetaInfoGroup.html" title="A group of meta information items about a file.">KFileMetaInfoGroup</a> g = d-&gt;groups[*it];
<a name="l00604"></a>00604         <span class="keywordflow">if</span> (g.<a class="code" href="classKFileMetaInfoGroup.html#aa1b5ddd8ed76fc7c48dd36df1a8d957a" title="Checks whether an item with the given key exists.">contains</a>(key)) <span class="keywordflow">return</span> <span class="keyword">true</span>;
<a name="l00605"></a>00605     }
<a name="l00606"></a>00606     <span class="keywordflow">return</span> <span class="keyword">false</span>;
<a name="l00607"></a>00607 }
<a name="l00608"></a>00608 
<a name="l00609"></a><a class="code" href="classKFileMetaInfo.html#a77023775f93b64f9c0b1728fa21b5412">00609</a> <span class="keywordtype">bool</span> <a class="code" href="classKFileMetaInfo.html#a77023775f93b64f9c0b1728fa21b5412" title="Checks whether a group with the given key exists.">KFileMetaInfo::containsGroup</a>(<span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>&amp; key)<span class="keyword"> const</span>
<a name="l00610"></a>00610 <span class="keyword"></span>{
<a name="l00611"></a>00611     <span class="keywordflow">return</span> <a class="code" href="classKFileMetaInfo.html#a50b0a84868c2c412d4d084a09ad8f5c7" title="Returns a list of all groups.">groups</a>().contains(key);
<a name="l00612"></a>00612 }
<a name="l00613"></a>00613 
<a name="l00614"></a><a class="code" href="classKFileMetaInfo.html#a49e8498204ac9b16d489a53a3d12e783">00614</a> <a class="code" href="classKFileMetaInfoItem.html" title="A meta information item about a file.">KFileMetaInfoItem</a> <a class="code" href="classKFileMetaInfo.html#a49e8498204ac9b16d489a53a3d12e783" title="Returns the KFileMetaInfoItem with the given key.">KFileMetaInfo::item</a>( <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>&amp; key)<span class="keyword"> const</span>
<a name="l00615"></a>00615 <span class="keyword"></span>{
<a name="l00616"></a>00616     <a class="codeRef" href="qstringlist.html">QStringList</a> <a class="code" href="classKFileMetaInfo.html#a50b0a84868c2c412d4d084a09ad8f5c7" title="Returns a list of all groups.">groups</a> = <a class="code" href="classKFileMetaInfo.html#aaa60c17a8eb2f7a90383ef87330dab88" title="Returns a list of the preferred groups.">preferredGroups</a>();
<a name="l00617"></a>00617     <span class="keywordflow">for</span> (QStringList::Iterator it = groups.begin(); it != groups.end(); ++it)
<a name="l00618"></a>00618     {
<a name="l00619"></a>00619         <a class="code" href="classKFileMetaInfoItem.html" title="A meta information item about a file.">KFileMetaInfoItem</a> i = d-&gt;groups[*it][key];
<a name="l00620"></a>00620         <span class="keywordflow">if</span> (i.<a class="code" href="classKFileMetaInfoItem.html#a94bef8631db1e076ffc0b7c943efb5b7" title="Return true if the item is valid, i.e.">isValid</a>()) <span class="keywordflow">return</span> i;
<a name="l00621"></a>00621     }
<a name="l00622"></a>00622     <span class="keywordflow">return</span> <a class="code" href="classKFileMetaInfoItem.html" title="A meta information item about a file.">KFileMetaInfoItem</a>();
<a name="l00623"></a>00623 }
<a name="l00624"></a>00624 
<a name="l00625"></a><a class="code" href="classKFileMetaInfo.html#a574d70af5c945b06181dde53c7825fba">00625</a> <a class="code" href="classKFileMetaInfoItem.html" title="A meta information item about a file.">KFileMetaInfoItem</a> <a class="code" href="classKFileMetaInfo.html#a49e8498204ac9b16d489a53a3d12e783" title="Returns the KFileMetaInfoItem with the given key.">KFileMetaInfo::item</a>(<span class="keyword">const</span> <a class="code" href="classKFileMimeTypeInfo.html#ac3f6af0479c6546e77d776a7f027f88d" title="This enum is mainly for items that have a special meaning for some applications.">KFileMetaInfoItem::Hint</a> hint)<span class="keyword"> const</span>
<a name="l00626"></a>00626 <span class="keyword"></span>{
<a name="l00627"></a>00627     <a class="codeRef" href="qstringlist.html">QStringList</a> <a class="code" href="classKFileMetaInfo.html#a50b0a84868c2c412d4d084a09ad8f5c7" title="Returns a list of all groups.">groups</a> = <a class="code" href="classKFileMetaInfo.html#aaa60c17a8eb2f7a90383ef87330dab88" title="Returns a list of the preferred groups.">preferredGroups</a>();
<a name="l00628"></a>00628     QStringList::ConstIterator it;
<a name="l00629"></a>00629     <span class="keywordflow">for</span> (it = groups.begin(); it != groups.end(); ++it)
<a name="l00630"></a>00630     {
<a name="l00631"></a>00631         <a class="code" href="classKFileMetaInfoItem.html" title="A meta information item about a file.">KFileMetaInfoItem</a> i = d-&gt;groups[*it].item(hint);
<a name="l00632"></a>00632         <span class="keywordflow">if</span> (i.<a class="code" href="classKFileMetaInfoItem.html#a94bef8631db1e076ffc0b7c943efb5b7" title="Return true if the item is valid, i.e.">isValid</a>()) <span class="keywordflow">return</span> i;
<a name="l00633"></a>00633     }
<a name="l00634"></a>00634     <span class="keywordflow">return</span> <a class="code" href="classKFileMetaInfoItem.html" title="A meta information item about a file.">KFileMetaInfoItem</a>();
<a name="l00635"></a>00635 }
<a name="l00636"></a>00636 
<a name="l00637"></a><a class="code" href="classKFileMetaInfo.html#ac18f3be8e7a776e1c00880d47c245c12">00637</a> <a class="code" href="classKFileMetaInfoItem.html" title="A meta information item about a file.">KFileMetaInfoItem</a> <a class="code" href="classKFileMetaInfo.html#ac18f3be8e7a776e1c00880d47c245c12" title="Saves the item with the given key.">KFileMetaInfo::saveItem</a>( <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>&amp; key,
<a name="l00638"></a>00638                                            <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>&amp; preferredGroup,
<a name="l00639"></a>00639                                            <span class="keywordtype">bool</span> createGroup )
<a name="l00640"></a>00640 {
<a name="l00641"></a>00641     assert(<a class="code" href="classKFileMetaInfo.html#a7fbb3ea4fc85133d4bd0534f7c684b1e" title="Returns true if the item is valid, i.e.">isValid</a>());
<a name="l00642"></a>00642     <span class="comment">// try the preferred groups first</span>
<a name="l00643"></a>00643     <span class="keywordflow">if</span> ( !preferredGroup.<a class="codeRef" href="qstring.html#isEmpty">isEmpty</a>() ) {
<a name="l00644"></a>00644         <a class="codeRef" href="qmapiterator.html">QMapIterator&lt;QString,KFileMetaInfoGroup&gt;</a> it =
<a name="l00645"></a>00645             d-&gt;groups.find( preferredGroup );
<a name="l00646"></a>00646 
<a name="l00647"></a>00647         <span class="comment">// try to create the preferred group, if necessary</span>
<a name="l00648"></a>00648         <span class="keywordflow">if</span> ( it == d-&gt;groups.end() &amp;&amp; createGroup ) {
<a name="l00649"></a>00649             <span class="keyword">const</span> <a class="code" href="classKFileMimeTypeInfo_1_1GroupInfo.html" title="Information about a meta information group.">KFileMimeTypeInfo::GroupInfo</a> *groupInfo =
<a name="l00650"></a>00650                 d-&gt;mimeTypeInfo-&gt;groupInfo( preferredGroup );
<a name="l00651"></a>00651             <span class="keywordflow">if</span> ( groupInfo &amp;&amp; groupInfo-&gt;<a class="code" href="classKFileMimeTypeInfo_1_1GroupInfo.html#ad1e96645fcd60435c8e090f79839d7f3" title="Use this method to get a list of keys in the specified group that the plugin knows about...">supportedKeys</a>().contains( key ) ) {
<a name="l00652"></a>00652                 <span class="keywordflow">if</span> ( <a class="code" href="classKFileMetaInfo.html#a4c22434c1a5ace0e4c8b576b9d64f0a1" title="Try to add the specified group.">addGroup</a>( preferredGroup ) )
<a name="l00653"></a>00653                     it = d-&gt;groups.find( preferredGroup );
<a name="l00654"></a>00654             }
<a name="l00655"></a>00655         }
<a name="l00656"></a>00656 
<a name="l00657"></a>00657         <span class="keywordflow">if</span> ( it != d-&gt;groups.end() ) {
<a name="l00658"></a>00658             <a class="code" href="classKFileMetaInfoItem.html" title="A meta information item about a file.">KFileMetaInfoItem</a> <a class="code" href="classKFileMetaInfo.html#a49e8498204ac9b16d489a53a3d12e783" title="Returns the KFileMetaInfoItem with the given key.">item</a> = it.<a class="codeRef" href="qmapiterator.html#data">data</a>().addItem( key );
<a name="l00659"></a>00659             <span class="keywordflow">if</span> ( item.<a class="code" href="classKFileMetaInfoItem.html#a94bef8631db1e076ffc0b7c943efb5b7" title="Return true if the item is valid, i.e.">isValid</a>() )
<a name="l00660"></a>00660                 <span class="keywordflow">return</span> item;
<a name="l00661"></a>00661         }
<a name="l00662"></a>00662     }
<a name="l00663"></a>00663 
<a name="l00664"></a>00664     <a class="codeRef" href="qstringlist.html">QStringList</a> <a class="code" href="classKFileMetaInfo.html#a50b0a84868c2c412d4d084a09ad8f5c7" title="Returns a list of all groups.">groups</a> = <a class="code" href="classKFileMetaInfo.html#aaa60c17a8eb2f7a90383ef87330dab88" title="Returns a list of the preferred groups.">preferredGroups</a>();
<a name="l00665"></a>00665 
<a name="l00666"></a>00666     <a class="code" href="classKFileMetaInfoItem.html" title="A meta information item about a file.">KFileMetaInfoItem</a> <a class="code" href="classKFileMetaInfo.html#a49e8498204ac9b16d489a53a3d12e783" title="Returns the KFileMetaInfoItem with the given key.">item</a>;
<a name="l00667"></a>00667 
<a name="l00668"></a>00668     QStringList::ConstIterator groupIt = groups.begin();
<a name="l00669"></a>00669     <span class="keywordflow">for</span> ( ; groupIt != groups.end(); ++groupIt )
<a name="l00670"></a>00670     {
<a name="l00671"></a>00671         <a class="codeRef" href="qmapiterator.html">QMapIterator&lt;QString,KFileMetaInfoGroup&gt;</a> it = d-&gt;groups.find( *groupIt );
<a name="l00672"></a>00672         <span class="keywordflow">if</span> ( it != d-&gt;groups.end() )
<a name="l00673"></a>00673         {
<a name="l00674"></a>00674             <a class="code" href="classKFileMetaInfoGroup.html" title="A group of meta information items about a file.">KFileMetaInfoGroup</a> <a class="code" href="classKFileMetaInfo.html#af98d53e2a06af8fd2959ab138f8d3817" title="Returns the KFileMetaInfoGroup with the given key.">group</a> = it.<a class="codeRef" href="qmapiterator.html#data">data</a>();
<a name="l00675"></a>00675             item = findEditableItem( group, key );
<a name="l00676"></a>00676             <span class="keywordflow">if</span> ( item.<a class="code" href="classKFileMetaInfoItem.html#a94bef8631db1e076ffc0b7c943efb5b7" title="Return true if the item is valid, i.e.">isValid</a>() )
<a name="l00677"></a>00677                 <span class="keywordflow">return</span> item;
<a name="l00678"></a>00678         }
<a name="l00679"></a>00679         <span class="keywordflow">else</span> <span class="comment">// not existant -- try to create the group</span>
<a name="l00680"></a>00680         {
<a name="l00681"></a>00681             <span class="keyword">const</span> <a class="code" href="classKFileMimeTypeInfo_1_1GroupInfo.html" title="Information about a meta information group.">KFileMimeTypeInfo::GroupInfo</a> *groupInfo =
<a name="l00682"></a>00682                 d-&gt;mimeTypeInfo-&gt;groupInfo( *groupIt );
<a name="l00683"></a>00683             <span class="keywordflow">if</span> ( groupInfo &amp;&amp; groupInfo-&gt;<a class="code" href="classKFileMimeTypeInfo_1_1GroupInfo.html#ad1e96645fcd60435c8e090f79839d7f3" title="Use this method to get a list of keys in the specified group that the plugin knows about...">supportedKeys</a>().contains( key ) )
<a name="l00684"></a>00684             {
<a name="l00685"></a>00685                 <span class="keywordflow">if</span> ( <a class="code" href="classKFileMetaInfo.html#a4c22434c1a5ace0e4c8b576b9d64f0a1" title="Try to add the specified group.">addGroup</a>( *groupIt ) )
<a name="l00686"></a>00686                 {
<a name="l00687"></a>00687                     <a class="code" href="classKFileMetaInfoGroup.html" title="A group of meta information items about a file.">KFileMetaInfoGroup</a> <a class="code" href="classKFileMetaInfo.html#af98d53e2a06af8fd2959ab138f8d3817" title="Returns the KFileMetaInfoGroup with the given key.">group</a> = d-&gt;groups[*groupIt];
<a name="l00688"></a>00688                     <a class="code" href="classKFileMetaInfoItem.html" title="A meta information item about a file.">KFileMetaInfoItem</a> item = group.<a class="code" href="classKFileMetaInfoGroup.html#ae401600d5901092c2f753e3ec619bf2b" title="Add an item to the info.">addItem</a>( key );
<a name="l00689"></a>00689                     <span class="keywordflow">if</span> ( item.<a class="code" href="classKFileMetaInfoItem.html#a94bef8631db1e076ffc0b7c943efb5b7" title="Return true if the item is valid, i.e.">isValid</a>() )
<a name="l00690"></a>00690                         <span class="keywordflow">return</span> item;
<a name="l00691"></a>00691 <span class="comment">//                     else ### add when removeGroup() is implemented :)</span>
<a name="l00692"></a>00692 <span class="comment">//                         removeGroup( *groupIt ); // couldn&#39;t add item -&gt; remove</span>
<a name="l00693"></a>00693                 }
<a name="l00694"></a>00694             }
<a name="l00695"></a>00695         }
<a name="l00696"></a>00696     }
<a name="l00697"></a>00697 
<a name="l00698"></a>00698     <span class="comment">// finally check for variable items</span>
<a name="l00699"></a>00699 
<a name="l00700"></a>00700     <span class="keywordflow">return</span> <a class="code" href="classKFileMetaInfo.html#a49e8498204ac9b16d489a53a3d12e783" title="Returns the KFileMetaInfoItem with the given key.">item</a>;
<a name="l00701"></a>00701 }
<a name="l00702"></a>00702 
<a name="l00703"></a>00703 <a class="code" href="classKFileMetaInfoItem.html" title="A meta information item about a file.">KFileMetaInfoItem</a> KFileMetaInfo::findEditableItem( <a class="code" href="classKFileMetaInfoGroup.html" title="A group of meta information items about a file.">KFileMetaInfoGroup</a>&amp; group,
<a name="l00704"></a>00704                                                    <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>&amp; key )
<a name="l00705"></a>00705 {
<a name="l00706"></a>00706     assert(<a class="code" href="classKFileMetaInfo.html#a7fbb3ea4fc85133d4bd0534f7c684b1e" title="Returns true if the item is valid, i.e.">isValid</a>());
<a name="l00707"></a>00707     <a class="code" href="classKFileMetaInfoItem.html" title="A meta information item about a file.">KFileMetaInfoItem</a> <a class="code" href="classKFileMetaInfo.html#a49e8498204ac9b16d489a53a3d12e783" title="Returns the KFileMetaInfoItem with the given key.">item</a> = group.<a class="code" href="classKFileMetaInfoGroup.html#ae401600d5901092c2f753e3ec619bf2b" title="Add an item to the info.">addItem</a>( key );
<a name="l00708"></a>00708     <span class="keywordflow">if</span> ( item.<a class="code" href="classKFileMetaInfoItem.html#a94bef8631db1e076ffc0b7c943efb5b7" title="Return true if the item is valid, i.e.">isValid</a>() &amp;&amp; item.<a class="code" href="classKFileMetaInfoItem.html#aa4e2b73fcb1f3bb953289fe940b5be71" title="You can query if the application can edit the item and write it back to the file with this method...">isEditable</a>() )
<a name="l00709"></a>00709          <span class="keywordflow">return</span> item;
<a name="l00710"></a>00710 
<a name="l00711"></a>00711     <span class="keywordflow">if</span> ( (d-&gt;mimeTypeInfo-&gt;groupInfo( group.<a class="code" href="classKFileMetaInfoGroup.html#ae8c602df4f81c84c8b56dfc5f432c526" title="The name of this group.">name</a>() )-&gt;attributes() &amp; <a class="code" href="classKFileMimeTypeInfo.html#a5d4779692b425b43302a9a113f91d59aadd6dc584228b4b24a9fcc23f93ffa8f5" title="The item or group can be added by a user.">KFileMimeTypeInfo::Addable</a>) )
<a name="l00712"></a>00712         <span class="keywordflow">return</span> <a class="code" href="classKFileMetaInfo.html#a49e8498204ac9b16d489a53a3d12e783" title="Returns the KFileMetaInfoItem with the given key.">item</a>;
<a name="l00713"></a>00713 
<a name="l00714"></a>00714     <span class="keywordflow">return</span> <a class="code" href="classKFileMetaInfoItem.html" title="A meta information item about a file.">KFileMetaInfoItem</a>();
<a name="l00715"></a>00715 }
<a name="l00716"></a>00716 
<a name="l00717"></a>00717 <a class="code" href="classKFileMetaInfoGroup.html" title="A group of meta information items about a file.">KFileMetaInfoGroup</a> KFileMetaInfo::appendGroup(<span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>&amp; name)
<a name="l00718"></a>00718 {
<a name="l00719"></a>00719     assert(<a class="code" href="classKFileMetaInfo.html#a7fbb3ea4fc85133d4bd0534f7c684b1e" title="Returns true if the item is valid, i.e.">isValid</a>());
<a name="l00720"></a>00720     <span class="keywordflow">if</span> ( d-&gt;mimeTypeInfo-&gt;supportedGroups().contains(name) &amp;&amp;
<a name="l00721"></a>00721          ! d-&gt;groups.contains(name) )
<a name="l00722"></a>00722     {
<a name="l00723"></a>00723         <a class="code" href="classKFileMetaInfoGroup.html" title="A group of meta information items about a file.">KFileMetaInfoGroup</a> <a class="code" href="classKFileMetaInfo.html#af98d53e2a06af8fd2959ab138f8d3817" title="Returns the KFileMetaInfoGroup with the given key.">group</a>( name, d-&gt;mimeTypeInfo );
<a name="l00724"></a>00724         d-&gt;groups.insert(name, group);
<a name="l00725"></a>00725         <span class="keywordflow">return</span> <a class="code" href="classKFileMetaInfo.html#af98d53e2a06af8fd2959ab138f8d3817" title="Returns the KFileMetaInfoGroup with the given key.">group</a>;
<a name="l00726"></a>00726     }
<a name="l00727"></a>00727 
<a name="l00728"></a>00728     <span class="keywordflow">else</span> {
<a name="l00729"></a>00729         kdWarning(7033) &lt;&lt; <span class="stringliteral">&quot;Someone&#39;s trying to add a KFileMetaInfoGroup which is not supported or already existing: &quot;</span> &lt;&lt; name &lt;&lt; endl;
<a name="l00730"></a>00730         <span class="keywordflow">return</span> <a class="code" href="classKFileMetaInfoGroup.html" title="A group of meta information items about a file.">KFileMetaInfoGroup</a>();
<a name="l00731"></a>00731     }
<a name="l00732"></a>00732 }
<a name="l00733"></a>00733 
<a name="l00734"></a><a class="code" href="classKFileMetaInfo.html#af91e110c26a3165bbd43db5017048100">00734</a> <a class="codeRef" href="qstring.html">QString</a> <a class="code" href="classKFileMetaInfo.html#af91e110c26a3165bbd43db5017048100" title="Returns the path of file - or QString::null if file is non-local.">KFileMetaInfo::path</a>()<span class="keyword"> const</span>
<a name="l00735"></a>00735 <span class="keyword"></span>{
<a name="l00736"></a>00736     <span class="keywordflow">return</span> d-&gt;url.isLocalFile() ? d-&gt;url.path() : QString::null;
<a name="l00737"></a>00737 }
<a name="l00738"></a>00738 
<a name="l00739"></a><a class="code" href="classKFileMetaInfo.html#ad418b0719f73bbefdd83c0d7a5e30e65">00739</a> KURL <a class="code" href="classKFileMetaInfo.html#ad418b0719f73bbefdd83c0d7a5e30e65" title="Returns the url of file.">KFileMetaInfo::url</a>()<span class="keyword"> const</span>
<a name="l00740"></a>00740 <span class="keyword"></span>{
<a name="l00741"></a>00741     <span class="keywordflow">return</span> d-&gt;url;
<a name="l00742"></a>00742 }
<a name="l00743"></a>00743 
<a name="l00744"></a>00744 <span class="keywordtype">void</span> KFileMetaInfo::ref()
<a name="l00745"></a>00745 {
<a name="l00746"></a>00746     <span class="keywordflow">if</span> (d != Data::null) d-&gt;ref();
<a name="l00747"></a>00747 
<a name="l00748"></a>00748 }
<a name="l00749"></a>00749 
<a name="l00750"></a>00750 <span class="keywordtype">void</span> KFileMetaInfo::deref()
<a name="l00751"></a>00751 {
<a name="l00752"></a>00752     <span class="comment">// We don&#39;t call makeNull here since it isn&#39;t necassery:</span>
<a name="l00753"></a>00753     <span class="comment">// If d is equal to null it means that null is initialized already.</span>
<a name="l00754"></a>00754     <span class="comment">// null is 0L when it hasn&#39;t been initialized and d is never 0L.</span>
<a name="l00755"></a>00755     <span class="keywordflow">if</span> ((d != Data::null) &amp;&amp; d-&gt;deref())
<a name="l00756"></a>00756     {
<a name="l00757"></a>00757 <span class="comment">//        kdDebug(7033) &lt;&lt; &quot;metainfo object for &quot; &lt;&lt; d-&gt;url.path &lt;&lt; &quot; is finally deleted\n&quot;;</span>
<a name="l00758"></a>00758         <span class="keyword">delete</span> d;
<a name="l00759"></a>00759         d = 0;
<a name="l00760"></a>00760     }
<a name="l00761"></a>00761 
<a name="l00762"></a>00762 }
<a name="l00763"></a>00763 
<a name="l00764"></a>00764 
<a name="l00765"></a>00765 KFileMetaInfo::Data* KFileMetaInfo::Data::null = 0L;
<a name="l00766"></a>00766 <span class="keyword">static</span> KStaticDeleter&lt;KFileMetaInfo::Data&gt; sd_KFileMetaInfoData;
<a name="l00767"></a>00767 
<a name="l00768"></a>00768 KFileMetaInfo::Data* KFileMetaInfo::Data::makeNull()
<a name="l00769"></a>00769 {
<a name="l00770"></a>00770     <span class="keywordflow">if</span> (!null)
<a name="l00771"></a>00771         <span class="comment">// We deliberately do not reset &quot;null&quot; after it has been destroyed!</span>
<a name="l00772"></a>00772         <span class="comment">// Otherwise we will run into problems later in ~KFileMetaInfoItem</span>
<a name="l00773"></a>00773         <span class="comment">// where the d-pointer is compared against null.</span>
<a name="l00774"></a>00774     null = sd_KFileMetaInfoData.setObject( <span class="keyword">new</span> KFileMetaInfo::Data(KURL(), 0) );
<a name="l00775"></a>00775     <span class="keywordflow">return</span> null;
<a name="l00776"></a>00776 }
<a name="l00777"></a>00777 
<a name="l00780"></a>00780 
<a name="l00781"></a><a class="code" href="classKFilePlugin.html#a9334dc446cc411b89adcb5a14fd97c1a">00781</a> <a class="code" href="classKFilePlugin.html#a9334dc446cc411b89adcb5a14fd97c1a" title="Creates a new KFilePlugin instance.">KFilePlugin::KFilePlugin</a>( <a class="codeRef" href="qobject.html">QObject</a> *parent, <span class="keyword">const</span> <span class="keywordtype">char</span> *name,
<a name="l00782"></a>00782                           <span class="keyword">const</span> <a class="codeRef" href="qstringlist.html">QStringList</a>&amp; <span class="comment">/*args*/</span>)
<a name="l00783"></a>00783     : <a class="codeRef" href="qobject.html">QObject</a>( parent, name )
<a name="l00784"></a>00784 {
<a name="l00785"></a>00785 <span class="comment">//    kdDebug(7033) &lt;&lt; &quot;loaded a plugin for &quot; &lt;&lt; name &lt;&lt; endl;</span>
<a name="l00786"></a>00786 }
<a name="l00787"></a>00787 
<a name="l00788"></a><a class="code" href="classKFilePlugin.html#a7c36be886ed93d136a89865ed97b8ca2">00788</a> <a class="code" href="classKFilePlugin.html#a7c36be886ed93d136a89865ed97b8ca2" title="Destructor.">KFilePlugin::~KFilePlugin</a>()
<a name="l00789"></a>00789 {
<a name="l00790"></a>00790 <span class="comment">//    kdDebug(7033) &lt;&lt; &quot;unloaded a plugin for &quot; &lt;&lt; name() &lt;&lt; endl;</span>
<a name="l00791"></a>00791 }
<a name="l00792"></a>00792 
<a name="l00793"></a><a class="code" href="classKFilePlugin.html#abe6ba88f026f0c6f3feda9634d293e87">00793</a> <a class="code" href="classKFileMimeTypeInfo.html" title="Represents the capabilities of a KFilePlugin for a given mimetype.">KFileMimeTypeInfo</a> * <a class="code" href="classKFilePlugin.html#abe6ba88f026f0c6f3feda9634d293e87" title="Call this from within your constructor to tell the KFile framework what mimetypes your plugin support...">KFilePlugin::addMimeTypeInfo</a>( <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>&amp; mimeType )
<a name="l00794"></a>00794 {
<a name="l00795"></a>00795     <span class="keywordflow">return</span> KFileMetaInfoProvider::self()-&gt;addMimeTypeInfo( mimeType );
<a name="l00796"></a>00796 }
<a name="l00797"></a>00797 
<a name="l00798"></a><a class="code" href="classKFilePlugin.html#a25b5765df5cfc9257895a39f5d35ada4">00798</a> <span class="keywordtype">void</span> <a class="code" href="classKFilePlugin.html#a25b5765df5cfc9257895a39f5d35ada4" title="Helper method to allow binary compatible extensions when needing &quot;new virtual methods&quot;.">KFilePlugin::virtual_hook</a>( <span class="keywordtype">int</span>, <span class="keywordtype">void</span>* )
<a name="l00799"></a>00799 { <span class="comment">/*BASE::virtual_hook( id, data );*/</span> }
<a name="l00800"></a>00800 
<a name="l00801"></a>00801 
<a name="l00802"></a><a class="code" href="classKFilePlugin.html#a00d4e5c4faabedbfd6faf95fa085acae">00802</a> <a class="code" href="classKFileMimeTypeInfo_1_1GroupInfo.html" title="Information about a meta information group.">KFileMimeTypeInfo::GroupInfo</a>*  <a class="code" href="classKFilePlugin.html#a00d4e5c4faabedbfd6faf95fa085acae" title="Creates a meta information group for KFileMimeTypeInfo object returned by addMimeTypeInfo().">KFilePlugin::addGroupInfo</a>(<a class="code" href="classKFileMimeTypeInfo.html" title="Represents the capabilities of a KFilePlugin for a given mimetype.">KFileMimeTypeInfo</a>* info,
<a name="l00803"></a>00803                   <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>&amp; key, <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>&amp; translatedKey)<span class="keyword"> const</span>
<a name="l00804"></a>00804 <span class="keyword"></span>{
<a name="l00805"></a>00805     <span class="keywordflow">return</span> info-&gt;addGroupInfo(key, translatedKey);
<a name="l00806"></a>00806 }
<a name="l00807"></a>00807 
<a name="l00808"></a><a class="code" href="classKFilePlugin.html#a964e2784ce59ff0b68979e8806ad28ae">00808</a> <span class="keywordtype">void</span> <a class="code" href="classKFilePlugin.html#a964e2784ce59ff0b68979e8806ad28ae" title="Sets attributes of the GroupInfo object returned by addGroupInfo().">KFilePlugin::setAttributes</a>(<a class="code" href="classKFileMimeTypeInfo_1_1GroupInfo.html" title="Information about a meta information group.">KFileMimeTypeInfo::GroupInfo</a>* gi, uint attr)<span class="keyword"> const</span>
<a name="l00809"></a>00809 <span class="keyword"></span>{
<a name="l00810"></a>00810     gi-&gt;m_attr = attr;
<a name="l00811"></a>00811 }
<a name="l00812"></a>00812 
<a name="l00813"></a>00813 <span class="keywordtype">void</span> KFilePlugin::addVariableInfo(<a class="code" href="classKFileMimeTypeInfo_1_1GroupInfo.html" title="Information about a meta information group.">KFileMimeTypeInfo::GroupInfo</a>* gi,
<a name="l00814"></a>00814                                   QVariant::Type type, uint attr)<span class="keyword"> const</span>
<a name="l00815"></a>00815 <span class="keyword"></span>{
<a name="l00816"></a>00816     gi-&gt;addVariableInfo(type, attr);
<a name="l00817"></a>00817 }
<a name="l00818"></a>00818 
<a name="l00819"></a><a class="code" href="classKFilePlugin.html#a9f3c5631358548f3b78b4a2de0c150f5">00819</a> <a class="code" href="classKFileMimeTypeInfo_1_1ItemInfo.html" title="This is the class for one item of a KFileMimeTypeInfo.">KFileMimeTypeInfo::ItemInfo</a>* <a class="code" href="classKFilePlugin.html#a9f3c5631358548f3b78b4a2de0c150f5" title="Adds a meta information item to a GroupInfo object as returned by addGroupInfo().">KFilePlugin::addItemInfo</a>(<a class="code" href="classKFileMimeTypeInfo_1_1GroupInfo.html" title="Information about a meta information group.">KFileMimeTypeInfo::GroupInfo</a>* gi,
<a name="l00820"></a>00820                                                      <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>&amp; key,
<a name="l00821"></a>00821                                                      <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>&amp; translatedKey,
<a name="l00822"></a>00822                                                      QVariant::Type type)
<a name="l00823"></a>00823 {
<a name="l00824"></a>00824     <span class="keywordflow">return</span> gi-&gt;addItemInfo(key, translatedKey, type);
<a name="l00825"></a>00825 }
<a name="l00826"></a>00826 
<a name="l00827"></a><a class="code" href="classKFilePlugin.html#ad849b4376fa7b37be7fc0a2c03d601bb">00827</a> <span class="keywordtype">void</span> <a class="code" href="classKFilePlugin.html#a964e2784ce59ff0b68979e8806ad28ae" title="Sets attributes of the GroupInfo object returned by addGroupInfo().">KFilePlugin::setAttributes</a>(<a class="code" href="classKFileMimeTypeInfo_1_1ItemInfo.html" title="This is the class for one item of a KFileMimeTypeInfo.">KFileMimeTypeInfo::ItemInfo</a>* item, uint attr)
<a name="l00828"></a>00828 {
<a name="l00829"></a>00829     item-&gt;m_attr = attr;
<a name="l00830"></a>00830 }
<a name="l00831"></a>00831 
<a name="l00832"></a><a class="code" href="classKFilePlugin.html#a8f8fff3427687144fcd574dad4389f17">00832</a> <span class="keywordtype">void</span> <a class="code" href="classKFilePlugin.html#a8f8fff3427687144fcd574dad4389f17" title="Defines the meaning of the meta information item.">KFilePlugin::setHint</a>(<a class="code" href="classKFileMimeTypeInfo_1_1ItemInfo.html" title="This is the class for one item of a KFileMimeTypeInfo.">KFileMimeTypeInfo::ItemInfo</a>* item, uint hint)
<a name="l00833"></a>00833 {
<a name="l00834"></a>00834     item-&gt;m_hint = hint;
<a name="l00835"></a>00835 }
<a name="l00836"></a>00836 
<a name="l00837"></a><a class="code" href="classKFilePlugin.html#a6b0f93b4b5593ec635e35a1f7d3882b0">00837</a> <span class="keywordtype">void</span> <a class="code" href="classKFilePlugin.html#a6b0f93b4b5593ec635e35a1f7d3882b0" title="Sets the unit used in the meta information item.">KFilePlugin::setUnit</a>(<a class="code" href="classKFileMimeTypeInfo_1_1ItemInfo.html" title="This is the class for one item of a KFileMimeTypeInfo.">KFileMimeTypeInfo::ItemInfo</a>* item, uint unit)
<a name="l00838"></a>00838 {
<a name="l00839"></a>00839     item-&gt;m_unit = unit;
<a name="l00840"></a>00840     <span class="comment">// set prefix and suffix</span>
<a name="l00841"></a>00841     <span class="keywordflow">switch</span> (unit)
<a name="l00842"></a>00842     {
<a name="l00843"></a>00843         <span class="keywordflow">case</span> <a class="code" href="classKFileMimeTypeInfo.html#a9f712056eacff37b74a7da6084590706a166a493323d541ecd4e86b8ca9eef9e8" title="The item represents a time in seconds.">KFileMimeTypeInfo::Seconds</a>:
<a name="l00844"></a>00844             item-&gt;m_suffix = i18n(<span class="stringliteral">&quot;s&quot;</span>); <span class="keywordflow">break</span>;
<a name="l00845"></a>00845 
<a name="l00846"></a>00846         <span class="keywordflow">case</span> <a class="code" href="classKFileMimeTypeInfo.html#a9f712056eacff37b74a7da6084590706ab79fed749328ca2ed279fb79d658999f" title="The item represents a time in milliseconds.">KFileMimeTypeInfo::MilliSeconds</a>:
<a name="l00847"></a>00847             item-&gt;m_suffix = i18n(<span class="stringliteral">&quot;ms&quot;</span>); <span class="keywordflow">break</span>;
<a name="l00848"></a>00848 
<a name="l00849"></a>00849         <span class="keywordflow">case</span> <a class="code" href="classKFileMimeTypeInfo.html#a9f712056eacff37b74a7da6084590706a760803ce4a2fac78739aa8fba67bc1c7" title="A bit rate.">KFileMimeTypeInfo::BitsPerSecond</a>:
<a name="l00850"></a>00850             item-&gt;m_suffix = i18n(<span class="stringliteral">&quot;bps&quot;</span>); <span class="keywordflow">break</span>;
<a name="l00851"></a>00851 
<a name="l00852"></a>00852         <span class="keywordflow">case</span> <a class="code" href="classKFileMimeTypeInfo.html#a9f712056eacff37b74a7da6084590706a42ba9b03a280477f85695e9e631976ce" title="For image dimensions and similar.">KFileMimeTypeInfo::Pixels</a>:
<a name="l00853"></a>00853             item-&gt;m_suffix = i18n(<span class="stringliteral">&quot;pixels&quot;</span>); <span class="keywordflow">break</span>;
<a name="l00854"></a>00854 
<a name="l00855"></a>00855         <span class="keywordflow">case</span> <a class="code" href="classKFileMimeTypeInfo.html#a9f712056eacff37b74a7da6084590706a4ff27b88cc0a160e1b8456c50dff1e6c" title="Sizes.">KFileMimeTypeInfo::Inches</a>:
<a name="l00856"></a>00856             item-&gt;m_suffix = i18n(<span class="stringliteral">&quot;in&quot;</span>); <span class="keywordflow">break</span>;
<a name="l00857"></a>00857 
<a name="l00858"></a>00858         <span class="keywordflow">case</span> <a class="code" href="classKFileMimeTypeInfo.html#a9f712056eacff37b74a7da6084590706aacd0ac242b63231f4c77711e4b4fe654" title="Sizes.">KFileMimeTypeInfo::Centimeters</a>:
<a name="l00859"></a>00859             item-&gt;m_suffix = i18n(<span class="stringliteral">&quot;cm&quot;</span>); <span class="keywordflow">break</span>;
<a name="l00860"></a>00860 
<a name="l00861"></a>00861         <span class="keywordflow">case</span> <a class="code" href="classKFileMimeTypeInfo.html#a9f712056eacff37b74a7da6084590706a8bf087061cbbdc8de3580df5db408ba7" title="Some data/file size in bytes.">KFileMimeTypeInfo::Bytes</a>:
<a name="l00862"></a>00862             item-&gt;m_suffix = i18n(<span class="stringliteral">&quot;B&quot;</span>); <span class="keywordflow">break</span>;
<a name="l00863"></a>00863 
<a name="l00864"></a>00864         <span class="keywordflow">case</span> <a class="code" href="classKFileMimeTypeInfo.html#a9f712056eacff37b74a7da6084590706aabc7d8b4850397b00de94477a937c9d0" title="Some data/file size in kilobytes.">KFileMimeTypeInfo::KiloBytes</a>:
<a name="l00865"></a>00865             item-&gt;m_suffix = i18n(<span class="stringliteral">&quot;KB&quot;</span>); <span class="keywordflow">break</span>;
<a name="l00866"></a>00866 
<a name="l00867"></a>00867         <span class="keywordflow">case</span> <a class="code" href="classKFileMimeTypeInfo.html#a9f712056eacff37b74a7da6084590706a65d3f7324d467790174fc40d15daea99" title="A frame rate.">KFileMimeTypeInfo::FramesPerSecond</a>:
<a name="l00868"></a>00868             item-&gt;m_suffix = i18n(<span class="stringliteral">&quot;fps&quot;</span>); <span class="keywordflow">break</span>;
<a name="l00869"></a>00869 
<a name="l00870"></a>00870         <span class="keywordflow">case</span> <a class="code" href="classKFileMimeTypeInfo.html#a9f712056eacff37b74a7da6084590706a6b4fcbd57d316d546f3f22995d07cf83" title="Resolution in DPI.">KFileMimeTypeInfo::DotsPerInch</a>:
<a name="l00871"></a>00871             item-&gt;m_suffix = i18n(<span class="stringliteral">&quot;dpi&quot;</span>); <span class="keywordflow">break</span>;
<a name="l00872"></a>00872 
<a name="l00873"></a>00873         <span class="keywordflow">case</span> <a class="code" href="classKFileMimeTypeInfo.html#a9f712056eacff37b74a7da6084590706ad94c99ed93ba7b181f5a45720e4ee8aa" title="A bit depth.">KFileMimeTypeInfo::BitsPerPixel</a>:
<a name="l00874"></a>00874             item-&gt;m_suffix = i18n(<span class="stringliteral">&quot;bpp&quot;</span>); <span class="keywordflow">break</span>;
<a name="l00875"></a>00875 
<a name="l00876"></a>00876         <span class="keywordflow">case</span> <a class="code" href="classKFileMimeTypeInfo.html#a9f712056eacff37b74a7da6084590706aafc013b8b2c26f68387ab4b06876dd35" title="Sample rates and similar.">KFileMimeTypeInfo::Hertz</a>:
<a name="l00877"></a>00877             item-&gt;m_suffix = i18n(<span class="stringliteral">&quot;Hz&quot;</span>); <span class="keywordflow">break</span>;
<a name="l00878"></a>00878 
<a name="l00879"></a>00879         <span class="keywordflow">case</span> <a class="code" href="classKFileMimeTypeInfo.html#a9f712056eacff37b74a7da6084590706a8cac78f9a5d2e225609075d78cd7a540" title="Sizes.">KFileMimeTypeInfo::Millimeters</a>:
<a name="l00880"></a>00880             item-&gt;m_suffix = i18n(<span class="stringliteral">&quot;mm&quot;</span>);
<a name="l00881"></a>00881     }
<a name="l00882"></a>00882 }
<a name="l00883"></a>00883 
<a name="l00884"></a><a class="code" href="classKFilePlugin.html#a81d976c6a6d4e454edb0e702e0f3833c">00884</a> <span class="keywordtype">void</span> <a class="code" href="classKFilePlugin.html#a81d976c6a6d4e454edb0e702e0f3833c" title="Sets a prefix string which is displayed before the item&#39;s value.">KFilePlugin::setPrefix</a>(<a class="code" href="classKFileMimeTypeInfo_1_1ItemInfo.html" title="This is the class for one item of a KFileMimeTypeInfo.">KFileMimeTypeInfo::ItemInfo</a>* item, <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>&amp; prefix)
<a name="l00885"></a>00885 {
<a name="l00886"></a>00886     item-&gt;m_prefix = prefix;
<a name="l00887"></a>00887 }
<a name="l00888"></a>00888 
<a name="l00889"></a><a class="code" href="classKFilePlugin.html#a61b90100af24f487533e1474a4b255e4">00889</a> <span class="keywordtype">void</span> <a class="code" href="classKFilePlugin.html#a61b90100af24f487533e1474a4b255e4" title="Sets a suffix string which is displayed before the item&#39;s value.">KFilePlugin::setSuffix</a>(<a class="code" href="classKFileMimeTypeInfo_1_1ItemInfo.html" title="This is the class for one item of a KFileMimeTypeInfo.">KFileMimeTypeInfo::ItemInfo</a>* item, <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>&amp; suffix)
<a name="l00890"></a>00890 {
<a name="l00891"></a>00891     item-&gt;m_suffix = suffix;
<a name="l00892"></a>00892 }
<a name="l00893"></a>00893 
<a name="l00894"></a><a class="code" href="classKFilePlugin.html#a07982f969f588d0c9d35f649a6c46c11">00894</a> <a class="code" href="classKFileMetaInfoGroup.html" title="A group of meta information items about a file.">KFileMetaInfoGroup</a> <a class="code" href="classKFilePlugin.html#a07982f969f588d0c9d35f649a6c46c11" title="Call this method from within readInfo() to indicate that you wish to fill meta information items of t...">KFilePlugin::appendGroup</a>(<a class="code" href="classKFileMetaInfo.html" title="Meta Information about a file.">KFileMetaInfo</a>&amp; info, <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>&amp; key)
<a name="l00895"></a>00895 {
<a name="l00896"></a>00896     <span class="keywordflow">return</span> info.appendGroup(key);
<a name="l00897"></a>00897 }
<a name="l00898"></a>00898 
<a name="l00899"></a><a class="code" href="classKFilePlugin.html#aeb943857bfb53ec7913247159abb0a18">00899</a> <span class="keywordtype">void</span> <a class="code" href="classKFilePlugin.html#aeb943857bfb53ec7913247159abb0a18" title="Call this method from within readInfo() to fill the meta information item identified by key with a va...">KFilePlugin::appendItem</a>(<a class="code" href="classKFileMetaInfoGroup.html" title="A group of meta information items about a file.">KFileMetaInfoGroup</a>&amp; group, <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>&amp; key, <a class="codeRef" href="qvariant.html">QVariant</a> value)
<a name="l00900"></a>00900 {
<a name="l00901"></a>00901     group.appendItem(key, value);
<a name="l00902"></a>00902 }
<a name="l00903"></a>00903 
<a name="l00906"></a>00906 
<a name="l00907"></a>00907 
<a name="l00908"></a>00908 KFileMetaInfoProvider * KFileMetaInfoProvider::s_self;
<a name="l00909"></a>00909 <span class="keyword">static</span> KStaticDeleter&lt;KFileMetaInfoProvider&gt; sd;
<a name="l00910"></a>00910 
<a name="l00911"></a>00911 KFileMetaInfoProvider * KFileMetaInfoProvider::self()
<a name="l00912"></a>00912 {
<a name="l00913"></a>00913     <span class="keywordflow">if</span> ( !s_self )
<a name="l00914"></a>00914         s_self = sd.setObject( s_self, <span class="keyword">new</span> KFileMetaInfoProvider() );
<a name="l00915"></a>00915 
<a name="l00916"></a>00916     <span class="keywordflow">return</span> s_self;
<a name="l00917"></a>00917 }
<a name="l00918"></a>00918 
<a name="l00919"></a>00919 KFileMetaInfoProvider::KFileMetaInfoProvider()
<a name="l00920"></a>00920 {
<a name="l00921"></a>00921     m_plugins.setAutoDelete( <span class="keyword">true</span> );
<a name="l00922"></a>00922 }
<a name="l00923"></a>00923 
<a name="l00924"></a>00924 KFileMetaInfoProvider::~KFileMetaInfoProvider()
<a name="l00925"></a>00925 {
<a name="l00926"></a>00926     m_plugins.clear();
<a name="l00927"></a>00927     sd.setObject( 0 );
<a name="l00928"></a>00928 }
<a name="l00929"></a>00929 
<a name="l00930"></a>00930 <a class="code" href="classKFilePlugin.html" title="Base class for a meta information plugin.">KFilePlugin</a>* KFileMetaInfoProvider::loadPlugin( <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>&amp; mimeType, <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>&amp; protocol )
<a name="l00931"></a>00931 {
<a name="l00932"></a>00932     <span class="comment">//kdDebug() &lt;&lt; &quot;loadPlugin: mimeType=&quot; &lt;&lt; mimeType &lt;&lt; &quot; protocol=&quot; &lt;&lt; protocol &lt;&lt; endl;</span>
<a name="l00933"></a>00933     <span class="comment">// Currently the idea is: either the mimetype is set or the protocol, but not both.</span>
<a name="l00934"></a>00934     <span class="comment">// We need PNG fileinfo, and trash: fileinfo, but not &quot;PNG in the trash&quot;.</span>
<a name="l00935"></a>00935     <a class="codeRef" href="qstring.html">QString</a> queryMimeType, query;
<a name="l00936"></a>00936     <span class="keywordflow">if</span> ( !mimeType.<a class="codeRef" href="qstring.html#isEmpty">isEmpty</a>() ) {
<a name="l00937"></a>00937         query = <span class="stringliteral">&quot;(not exist [X-KDE-Protocol])&quot;</span>;
<a name="l00938"></a>00938         queryMimeType = mimeType;
<a name="l00939"></a>00939     } <span class="keywordflow">else</span> {
<a name="l00940"></a>00940         query = <a class="codeRef" href="qstring.html#fromLatin1">QString::fromLatin1</a>( <span class="stringliteral">&quot;[X-KDE-Protocol] == &#39;%1&#39;&quot;</span> ).arg(protocol);
<a name="l00941"></a>00941         <span class="comment">// querying for a protocol: we have no mimetype, so we need to use KFilePlugin as one</span>
<a name="l00942"></a>00942         queryMimeType = <span class="stringliteral">&quot;KFilePlugin&quot;</span>;
<a name="l00943"></a>00943         <span class="comment">// hopefully using KFilePlugin as genericMimeType too isn&#39;t a problem</span>
<a name="l00944"></a>00944     }
<a name="l00945"></a>00945     <span class="keyword">const</span> <a class="codeRef" href="qvaluelist.html">KTrader::OfferList</a> offers = <a class="code" href="classKTrader.html#a3fce6f1332504c3f4621b18cf8635ce0" title="This is a static pointer to a KTrader instance.">KTrader::self</a>()-&gt;<a class="code" href="classKTrader.html#af317c76b7cfb2a1e8ccc0df72676b2d5" title="The main function in the KTrader class.">query</a>( queryMimeType, <span class="stringliteral">&quot;KFilePlugin&quot;</span>, query, QString::null );
<a name="l00946"></a>00946     <span class="keywordflow">if</span> ( offers.<a class="codeRef" href="qvaluelist.html#isEmpty">isEmpty</a>() )
<a name="l00947"></a>00947         <span class="keywordflow">return</span> 0;
<a name="l00948"></a>00948     KService::Ptr service = *(offers.<a class="codeRef" href="qvaluelist.html#begin">begin</a>());
<a name="l00949"></a>00949     Q_ASSERT( service &amp;&amp; service-&gt;isValid() );
<a name="l00950"></a>00950     <span class="keywordflow">if</span> ( !service || !service-&gt;isValid() )
<a name="l00951"></a>00951         <span class="keywordflow">return</span> 0;
<a name="l00952"></a>00952 
<a name="l00953"></a>00953     <a class="code" href="classKFilePlugin.html" title="Base class for a meta information plugin.">KFilePlugin</a>* plugin = KParts::ComponentFactory::createInstanceFromService&lt;KFilePlugin&gt;
<a name="l00954"></a>00954                           ( service, <span class="keyword">this</span>, mimeType.<a class="codeRef" href="qstring.html#local8Bit">local8Bit</a>() );
<a name="l00955"></a>00955     <span class="keywordflow">if</span> (!plugin)
<a name="l00956"></a>00956         kdWarning(7033) &lt;&lt; <span class="stringliteral">&quot;error loading the plugin from &quot;</span> &lt;&lt; service-&gt;desktopEntryPath() &lt;&lt; endl;
<a name="l00957"></a>00957 
<a name="l00958"></a>00958     <span class="keywordflow">return</span> plugin;
<a name="l00959"></a>00959 }
<a name="l00960"></a>00960 
<a name="l00961"></a>00961 <a class="code" href="classKFilePlugin.html" title="Base class for a meta information plugin.">KFilePlugin</a>* KFileMetaInfoProvider::loadAndRegisterPlugin( <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>&amp; mimeType, <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>&amp; protocol )
<a name="l00962"></a>00962 {
<a name="l00963"></a>00963     Q_ASSERT( m_pendingMimetypeInfos.isEmpty() );
<a name="l00964"></a>00964     m_pendingMimetypeInfos.clear();
<a name="l00965"></a>00965 
<a name="l00966"></a>00966     <a class="code" href="classKFilePlugin.html" title="Base class for a meta information plugin.">KFilePlugin</a>* plugin = loadPlugin( mimeType, protocol );
<a name="l00967"></a>00967     <span class="keywordflow">if</span> ( !plugin ) {
<a name="l00968"></a>00968         <span class="comment">// No plugin found. Remember that, to save time.</span>
<a name="l00969"></a>00969         m_plugins.insert( protocol.<a class="codeRef" href="qstring.html#isEmpty">isEmpty</a>() ? mimeType : protocol, <span class="keyword">new</span> CachedPluginInfo );
<a name="l00970"></a>00970         <span class="keywordflow">return</span> 0;
<a name="l00971"></a>00971     }
<a name="l00972"></a>00972 
<a name="l00973"></a>00973     <span class="keywordflow">if</span> ( !protocol.<a class="codeRef" href="qstring.html#isEmpty">isEmpty</a>() ) {
<a name="l00974"></a>00974         <span class="comment">// Protocol-metainfo: only one entry</span>
<a name="l00975"></a>00975         Q_ASSERT( m_pendingMimetypeInfos.count() == 1 );
<a name="l00976"></a>00976         <a class="code" href="classKFileMimeTypeInfo.html" title="Represents the capabilities of a KFilePlugin for a given mimetype.">KFileMimeTypeInfo</a>* info = m_pendingMimetypeInfos[ protocol ];
<a name="l00977"></a>00977         Q_ASSERT( info );
<a name="l00978"></a>00978         m_plugins.insert( protocol, <span class="keyword">new</span> CachedPluginInfo( plugin, info, <span class="keyword">true</span> ) );
<a name="l00979"></a>00979     } <span class="keywordflow">else</span> {
<a name="l00980"></a>00980         <span class="comment">// Mimetype-metainfo: the plugin can register itself for multiple mimetypes, remember them all</span>
<a name="l00981"></a>00981         <span class="keywordtype">bool</span> first = <span class="keyword">true</span>;
<a name="l00982"></a>00982         <a class="codeRef" href="qdictiterator.html">QDictIterator&lt;KFileMimeTypeInfo&gt;</a> it( m_pendingMimetypeInfos );
<a name="l00983"></a>00983         <span class="keywordflow">for</span>( ; it.current(); ++it ) {
<a name="l00984"></a>00984             <a class="code" href="classKFileMimeTypeInfo.html" title="Represents the capabilities of a KFilePlugin for a given mimetype.">KFileMimeTypeInfo</a>* info = it.current();
<a name="l00985"></a>00985             m_plugins.insert( it.currentKey(), <span class="keyword">new</span> CachedPluginInfo( plugin, info, first ) );
<a name="l00986"></a>00986             first = <span class="keyword">false</span>;
<a name="l00987"></a>00987         }
<a name="l00988"></a>00988         <span class="comment">// Hopefully the above includes the mimetype we asked for!</span>
<a name="l00989"></a>00989         <span class="keywordflow">if</span> ( m_pendingMimetypeInfos.find( mimeType ) == 0 )
<a name="l00990"></a>00990             kdWarning(7033) &lt;&lt; plugin-&gt;<a class="codeRef" href="qobject.html#className">className</a>() &lt;&lt; <span class="stringliteral">&quot; was created for &quot;</span> &lt;&lt; mimeType &lt;&lt; <span class="stringliteral">&quot; but doesn&#39;t call addMimeTypeInfo for it!&quot;</span> &lt;&lt; endl;
<a name="l00991"></a>00991     }
<a name="l00992"></a>00992     m_pendingMimetypeInfos.clear();
<a name="l00993"></a>00993     <span class="keywordflow">return</span> plugin;
<a name="l00994"></a>00994 }
<a name="l00995"></a>00995 
<a name="l00996"></a>00996 <a class="code" href="classKFilePlugin.html" title="Base class for a meta information plugin.">KFilePlugin</a> * KFileMetaInfoProvider::plugin(<span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>&amp; mimeType)
<a name="l00997"></a>00997 {
<a name="l00998"></a>00998     <span class="keywordflow">return</span> plugin( mimeType, QString::null );
<a name="l00999"></a>00999 }
<a name="l01000"></a>01000 
<a name="l01001"></a>01001 <a class="code" href="classKFilePlugin.html" title="Base class for a meta information plugin.">KFilePlugin</a> * KFileMetaInfoProvider::plugin(<span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>&amp; mimeType, <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>&amp; protocol)
<a name="l01002"></a>01002 {
<a name="l01003"></a>01003     <span class="comment">//kdDebug(7033) &lt;&lt; &quot;plugin() : looking for plugin for protocol=&quot; &lt;&lt; protocol &lt;&lt; &quot; mimeType=&quot; &lt;&lt; mimeType &lt;&lt; endl;</span>
<a name="l01004"></a>01004 
<a name="l01005"></a>01005     <span class="keywordflow">if</span> ( !protocol.<a class="codeRef" href="qstring.html#isEmpty">isEmpty</a>() ) {
<a name="l01006"></a>01006         CachedPluginInfo *cache = m_plugins.find( protocol );
<a name="l01007"></a>01007         <span class="keywordflow">if</span> ( cache &amp;&amp; cache-&gt;plugin ) {
<a name="l01008"></a>01008             <span class="keywordflow">return</span> cache-&gt;plugin;
<a name="l01009"></a>01009         }
<a name="l01010"></a>01010         <span class="keywordflow">if</span> ( !cache ) {
<a name="l01011"></a>01011             <a class="code" href="classKFilePlugin.html" title="Base class for a meta information plugin.">KFilePlugin</a>* plugin = loadAndRegisterPlugin( QString::null, protocol );
<a name="l01012"></a>01012             <span class="keywordflow">if</span> ( plugin )
<a name="l01013"></a>01013                 <span class="keywordflow">return</span> plugin;
<a name="l01014"></a>01014         }
<a name="l01015"></a>01015     }
<a name="l01016"></a>01016 
<a name="l01017"></a>01017     CachedPluginInfo *cache = m_plugins.find( mimeType );
<a name="l01018"></a>01018     <span class="keywordflow">if</span> ( cache ) {
<a name="l01019"></a>01019         <span class="keywordflow">return</span> cache-&gt;plugin;
<a name="l01020"></a>01020     }
<a name="l01021"></a>01021 
<a name="l01022"></a>01022     <a class="code" href="classKFilePlugin.html" title="Base class for a meta information plugin.">KFilePlugin</a>* plugin = loadAndRegisterPlugin( mimeType, QString::null );
<a name="l01023"></a>01023 
<a name="l01024"></a>01024 <span class="preprocessor">#if 0</span>
<a name="l01025"></a>01025 <span class="preprocessor"></span>    kdDebug(7033) &lt;&lt; <span class="stringliteral">&quot;currently loaded plugins:\n&quot;</span>;
<a name="l01026"></a>01026 
<a name="l01027"></a>01027     <a class="codeRef" href="qdictiterator.html">QDictIterator&lt;CachedPluginInfo&gt;</a> it( m_plugins );
<a name="l01028"></a>01028     <span class="keywordflow">for</span>( ; it.current(); ++it ) {
<a name="l01029"></a>01029         CachedPluginInfo* cache = it.current();
<a name="l01030"></a>01030         kdDebug(7033)
<a name="l01031"></a>01031             &lt;&lt; it.currentKey() <span class="comment">// mimetype or protocol</span>
<a name="l01032"></a>01032             &lt;&lt; <span class="stringliteral">&quot; : &quot;</span> &lt;&lt; (cache-&gt;plugin ? cache-&gt;plugin-&gt;className() : <span class="stringliteral">&quot;(no plugin)&quot;</span>) &lt;&lt; endl; <span class="comment">// plugin</span>
<a name="l01033"></a>01033         <span class="comment">// TODO print cache-&gt;mimeTypeInfo</span>
<a name="l01034"></a>01034     }
<a name="l01035"></a>01035 <span class="preprocessor">#endif</span>
<a name="l01036"></a>01036 <span class="preprocessor"></span>
<a name="l01037"></a>01037     <span class="keywordflow">return</span> plugin;
<a name="l01038"></a>01038 }
<a name="l01039"></a>01039 
<a name="l01040"></a>01040 <a class="codeRef" href="qstringlist.html">QStringList</a> KFileMetaInfoProvider::preferredKeys( <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>&amp; mimeType )<span class="keyword"> const</span>
<a name="l01041"></a>01041 <span class="keyword"></span>{
<a name="l01042"></a>01042     KService::Ptr service =
<a name="l01043"></a>01043         <a class="code" href="classKServiceTypeProfile.html#a557b197082892e32adc88dee68d8e37e" title="Returns the preferred service for _serviceType and _genericServiceType (&quot;Application&quot;, type of component, or null).">KServiceTypeProfile::preferredService</a>( mimeType, <span class="stringliteral">&quot;KFilePlugin&quot;</span>);
<a name="l01044"></a>01044 
<a name="l01045"></a>01045     <span class="keywordflow">if</span> ( !service || !service-&gt;isValid() )
<a name="l01046"></a>01046     {
<a name="l01047"></a>01047 <span class="comment">//        kdDebug(7033) &lt;&lt; &quot;no valid service found\n&quot;;</span>
<a name="l01048"></a>01048         <span class="keywordflow">return</span> <a class="codeRef" href="qstringlist.html">QStringList</a>();
<a name="l01049"></a>01049     }
<a name="l01050"></a>01050     <span class="keywordflow">return</span> service-&gt;property(<span class="stringliteral">&quot;PreferredItems&quot;</span>).toStringList();
<a name="l01051"></a>01051 }
<a name="l01052"></a>01052 
<a name="l01053"></a>01053 <a class="codeRef" href="qstringlist.html">QStringList</a> KFileMetaInfoProvider::preferredGroups( <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>&amp; mimeType )<span class="keyword"> const</span>
<a name="l01054"></a>01054 <span class="keyword"></span>{
<a name="l01055"></a>01055     KService::Ptr service =
<a name="l01056"></a>01056         <a class="code" href="classKServiceTypeProfile.html#a557b197082892e32adc88dee68d8e37e" title="Returns the preferred service for _serviceType and _genericServiceType (&quot;Application&quot;, type of component, or null).">KServiceTypeProfile::preferredService</a>( mimeType, <span class="stringliteral">&quot;KFilePlugin&quot;</span>);
<a name="l01057"></a>01057 
<a name="l01058"></a>01058     <span class="keywordflow">if</span> ( !service || !service-&gt;isValid() )
<a name="l01059"></a>01059     {
<a name="l01060"></a>01060 <span class="comment">//        kdDebug(7033) &lt;&lt; &quot;no valid service found\n&quot;;</span>
<a name="l01061"></a>01061         <span class="keywordflow">return</span> <a class="codeRef" href="qstringlist.html">QStringList</a>();
<a name="l01062"></a>01062     }
<a name="l01063"></a>01063     <span class="keywordflow">return</span> service-&gt;property(<span class="stringliteral">&quot;PreferredGroups&quot;</span>).toStringList();
<a name="l01064"></a>01064 }
<a name="l01065"></a>01065 
<a name="l01066"></a>01066 <span class="keyword">const</span> <a class="code" href="classKFileMimeTypeInfo.html" title="Represents the capabilities of a KFilePlugin for a given mimetype.">KFileMimeTypeInfo</a> * KFileMetaInfoProvider::mimeTypeInfo( <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>&amp; mimeType )
<a name="l01067"></a>01067 {
<a name="l01068"></a>01068     <span class="keywordflow">return</span> mimeTypeInfo( mimeType, QString::null );
<a name="l01069"></a>01069 }
<a name="l01070"></a>01070 
<a name="l01071"></a>01071 <span class="keyword">const</span> <a class="code" href="classKFileMimeTypeInfo.html" title="Represents the capabilities of a KFilePlugin for a given mimetype.">KFileMimeTypeInfo</a> * KFileMetaInfoProvider::mimeTypeInfo( <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>&amp; mimeType, <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>&amp; protocol )
<a name="l01072"></a>01072 {
<a name="l01073"></a>01073     <span class="comment">//kdDebug(7033) &lt;&lt; &quot;mimeTypeInfo() : looking for plugin for protocol=&quot; &lt;&lt; protocol &lt;&lt; &quot; mimeType=&quot; &lt;&lt; mimeType &lt;&lt; endl;</span>
<a name="l01074"></a>01074     <span class="keywordflow">if</span> ( !protocol.<a class="codeRef" href="qstring.html#isEmpty">isEmpty</a>() ) {
<a name="l01075"></a>01075         CachedPluginInfo *cache = m_plugins.find( protocol );
<a name="l01076"></a>01076         <span class="keywordflow">if</span> ( cache &amp;&amp; cache-&gt;mimeTypeInfo ) {
<a name="l01077"></a>01077             <span class="keywordflow">return</span> cache-&gt;mimeTypeInfo;
<a name="l01078"></a>01078         }
<a name="l01079"></a>01079 
<a name="l01080"></a>01080         <span class="keywordflow">if</span> ( !cache ) {
<a name="l01081"></a>01081             loadAndRegisterPlugin( QString::null, protocol );
<a name="l01082"></a>01082             cache = m_plugins.find( protocol );
<a name="l01083"></a>01083             <span class="keywordflow">if</span> ( cache &amp;&amp; cache-&gt;mimeTypeInfo ) {
<a name="l01084"></a>01084                 <span class="keywordflow">return</span> cache-&gt;mimeTypeInfo;
<a name="l01085"></a>01085             }
<a name="l01086"></a>01086         }
<a name="l01087"></a>01087     }
<a name="l01088"></a>01088 
<a name="l01089"></a>01089     CachedPluginInfo *cache = m_plugins.find( mimeType );
<a name="l01090"></a>01090     <span class="keywordflow">if</span> ( cache ) {
<a name="l01091"></a>01091         <span class="keywordflow">return</span> cache-&gt;mimeTypeInfo;
<a name="l01092"></a>01092     }
<a name="l01093"></a>01093 
<a name="l01094"></a>01094     loadAndRegisterPlugin( mimeType, QString::null );
<a name="l01095"></a>01095     cache = m_plugins.find( mimeType );
<a name="l01096"></a>01096     <span class="keywordflow">if</span> ( cache ) {
<a name="l01097"></a>01097         <span class="keywordflow">return</span> cache-&gt;mimeTypeInfo;
<a name="l01098"></a>01098     }
<a name="l01099"></a>01099     <span class="keywordflow">return</span> 0;
<a name="l01100"></a>01100 }
<a name="l01101"></a>01101 
<a name="l01102"></a>01102 <a class="code" href="classKFileMimeTypeInfo.html" title="Represents the capabilities of a KFilePlugin for a given mimetype.">KFileMimeTypeInfo</a> * KFileMetaInfoProvider::addMimeTypeInfo(
<a name="l01103"></a>01103     <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>&amp; mimeType )
<a name="l01104"></a>01104 {
<a name="l01105"></a>01105 
<a name="l01106"></a>01106     <a class="code" href="classKFileMimeTypeInfo.html" title="Represents the capabilities of a KFilePlugin for a given mimetype.">KFileMimeTypeInfo</a> *info = m_pendingMimetypeInfos.find( mimeType );
<a name="l01107"></a>01107     Q_ASSERT( !info );
<a name="l01108"></a>01108     <span class="keywordflow">if</span> ( !info )
<a name="l01109"></a>01109     {
<a name="l01110"></a>01110         info = <span class="keyword">new</span> <a class="code" href="classKFileMimeTypeInfo.html" title="Represents the capabilities of a KFilePlugin for a given mimetype.">KFileMimeTypeInfo</a>( mimeType );
<a name="l01111"></a>01111         m_pendingMimetypeInfos.insert( mimeType, info );
<a name="l01112"></a>01112     }
<a name="l01113"></a>01113 
<a name="l01114"></a>01114     info-&gt;m_preferredKeys    = preferredKeys( mimeType );
<a name="l01115"></a>01115     info-&gt;m_preferredGroups  = preferredGroups( mimeType );
<a name="l01116"></a>01116 
<a name="l01117"></a>01117     <span class="keywordflow">return</span> info;
<a name="l01118"></a>01118 }
<a name="l01119"></a>01119 
<a name="l01120"></a>01120 <a class="codeRef" href="qstringlist.html">QStringList</a> KFileMetaInfoProvider::supportedMimeTypes()<span class="keyword"> const</span>
<a name="l01121"></a>01121 <span class="keyword"></span>{
<a name="l01122"></a>01122     <a class="codeRef" href="qstringlist.html">QStringList</a> allMimeTypes;
<a name="l01123"></a>01123     <a class="codeRef" href="qstring.html">QString</a> kfilePlugin = <span class="stringliteral">&quot;KFilePlugin&quot;</span>;
<a name="l01124"></a>01124 
<a name="l01125"></a>01125     <a class="codeRef" href="qvaluelist.html">KTrader::OfferList</a> offers = <a class="code" href="classKTrader.html#a3fce6f1332504c3f4621b18cf8635ce0" title="This is a static pointer to a KTrader instance.">KTrader::self</a>()-&gt;<a class="code" href="classKTrader.html#af317c76b7cfb2a1e8ccc0df72676b2d5" title="The main function in the KTrader class.">query</a>( <span class="stringliteral">&quot;KFilePlugin&quot;</span> );
<a name="l01126"></a>01126     <a class="codeRef" href="qvaluelistiterator.html">KTrader::OfferListIterator</a> it = offers.<a class="codeRef" href="qvaluelist.html#begin">begin</a>();
<a name="l01127"></a>01127     <span class="keywordflow">for</span> ( ; it != offers.<a class="codeRef" href="qvaluelist.html#end">end</a>(); ++it )
<a name="l01128"></a>01128     {
<a name="l01129"></a>01129         <span class="keyword">const</span> <a class="codeRef" href="qstringlist.html">QStringList</a> mimeTypes = (*it)-&gt;serviceTypes();
<a name="l01130"></a>01130         QStringList::ConstIterator it2 = mimeTypes.begin();
<a name="l01131"></a>01131         <span class="keywordflow">for</span> ( ; it2 != mimeTypes.end(); ++it2 )
<a name="l01132"></a>01132             <span class="keywordflow">if</span> ( allMimeTypes.find( *it2 ) == allMimeTypes.end() &amp;&amp;
<a name="l01133"></a>01133                  *it2 != kfilePlugin ) <span class="comment">// also in serviceTypes()</span>
<a name="l01134"></a>01134                 allMimeTypes.append( *it2 );
<a name="l01135"></a>01135     }
<a name="l01136"></a>01136 
<a name="l01137"></a>01137     <span class="keywordflow">return</span> allMimeTypes;
<a name="l01138"></a>01138 }
<a name="l01139"></a>01139 
<a name="l01144"></a>01144 
<a name="l01145"></a>01145 
<a name="l01146"></a>01146 <span class="comment">// shared data of a KFileMetaInfoGroup</span>
<a name="l01147"></a>01147 <span class="keyword">class </span>KFileMetaInfoGroup::Data : <span class="keyword">public</span> QShared
<a name="l01148"></a>01148 {
<a name="l01149"></a>01149 <span class="keyword">public</span>:
<a name="l01150"></a>01150     Data(<span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>&amp; _name)
<a name="l01151"></a>01151         : QShared(),
<a name="l01152"></a>01152           name(_name),
<a name="l01153"></a>01153           mimeTypeInfo(0L),
<a name="l01154"></a>01154           dirty( false ),
<a name="l01155"></a>01155           added( false )
<a name="l01156"></a>01156     {}
<a name="l01157"></a>01157 
<a name="l01158"></a>01158     <span class="comment">// we use this one for the streaming operators</span>
<a name="l01159"></a>01159     Data() : mimeTypeInfo(0L) {}
<a name="l01160"></a>01160     ~Data() {
<a name="l01161"></a>01161         <span class="keywordflow">if</span> ( <span class="keyword">this</span> == null )
<a name="l01162"></a>01162             <span class="keyword">delete</span> mimeTypeInfo;
<a name="l01163"></a>01163     };
<a name="l01164"></a>01164 
<a name="l01165"></a>01165     <a class="codeRef" href="qstring.html">QString</a>                             <a class="code" href="classKFileMetaInfoGroup.html#ae8c602df4f81c84c8b56dfc5f432c526" title="The name of this group.">name</a>;
<a name="l01166"></a>01166     <a class="codeRef" href="qmap.html">QMap&lt;QString, KFileMetaInfoItem&gt;</a>    items;
<a name="l01167"></a>01167     <span class="keyword">const</span> <a class="code" href="classKFileMimeTypeInfo.html" title="Represents the capabilities of a KFilePlugin for a given mimetype.">KFileMimeTypeInfo</a>*            mimeTypeInfo;
<a name="l01168"></a>01168     <a class="codeRef" href="qstringlist.html">QStringList</a>                         <a class="code" href="classKFileMetaInfoGroup.html#ae421714b0df6f7459dee6766be5bad35" title="Returns a list of all removed items.">removedItems</a>;
<a name="l01169"></a>01169     <span class="keywordtype">bool</span>                                dirty   :1;
<a name="l01170"></a>01170     <span class="keywordtype">bool</span>                                added   :1;
<a name="l01171"></a>01171 
<a name="l01172"></a>01172     <span class="keyword">static</span> Data* null;
<a name="l01173"></a>01173     <span class="keyword">static</span> Data* makeNull();
<a name="l01174"></a>01174 
<a name="l01175"></a>01175 };
<a name="l01176"></a>01176 
<a name="l01177"></a>01177 <a class="code" href="classKFileMetaInfoGroup.html#af9b4abeff8fac26703e936d9cae9ad03" title="Default constructor.">KFileMetaInfoGroup::KFileMetaInfoGroup</a>( <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>&amp; name,
<a name="l01178"></a>01178                                         <span class="keyword">const</span> <a class="code" href="classKFileMimeTypeInfo.html" title="Represents the capabilities of a KFilePlugin for a given mimetype.">KFileMimeTypeInfo</a>* info )
<a name="l01179"></a>01179     : d(new Data( name ) )
<a name="l01180"></a>01180 {
<a name="l01181"></a>01181       d-&gt;mimeTypeInfo = info;
<a name="l01182"></a>01182 }
<a name="l01183"></a>01183 
<a name="l01184"></a><a class="code" href="classKFileMetaInfoGroup.html#ae6ddb94462fd31383abf432aae58c5ec">01184</a> <a class="code" href="classKFileMetaInfoGroup.html#af9b4abeff8fac26703e936d9cae9ad03" title="Default constructor.">KFileMetaInfoGroup::KFileMetaInfoGroup</a>( <span class="keyword">const</span> <a class="code" href="classKFileMetaInfoGroup.html" title="A group of meta information items about a file.">KFileMetaInfoGroup</a>&amp; original )
<a name="l01185"></a>01185 {
<a name="l01186"></a>01186     <span class="comment">// operator= does everything that&#39;s necessary</span>
<a name="l01187"></a>01187     d = Data::makeNull();
<a name="l01188"></a>01188     *<span class="keyword">this</span> = original;
<a name="l01189"></a>01189 }
<a name="l01190"></a>01190 
<a name="l01191"></a><a class="code" href="classKFileMetaInfoGroup.html#af9b4abeff8fac26703e936d9cae9ad03">01191</a> <a class="code" href="classKFileMetaInfoGroup.html#af9b4abeff8fac26703e936d9cae9ad03" title="Default constructor.">KFileMetaInfoGroup::KFileMetaInfoGroup</a>()
<a name="l01192"></a>01192 {
<a name="l01193"></a>01193     d = Data::makeNull();
<a name="l01194"></a>01194 }
<a name="l01195"></a>01195 
<a name="l01196"></a>01196 KFileMetaInfoGroup::~KFileMetaInfoGroup()
<a name="l01197"></a>01197 {
<a name="l01198"></a>01198     deref();
<a name="l01199"></a>01199 }
<a name="l01200"></a>01200 
<a name="l01201"></a><a class="code" href="classKFileMetaInfoGroup.html#a86ccddb8248a50c21c6e85812201f6d9">01201</a> <span class="keyword">const</span> <a class="code" href="classKFileMetaInfoGroup.html" title="A group of meta information items about a file.">KFileMetaInfoGroup</a>&amp; <a class="code" href="classKFileMetaInfoGroup.html#a86ccddb8248a50c21c6e85812201f6d9" title="The assignment operator, so you can do:">KFileMetaInfoGroup::operator= </a>(<span class="keyword">const</span> <a class="code" href="classKFileMetaInfoGroup.html" title="A group of meta information items about a file.">KFileMetaInfoGroup</a>&amp; info )
<a name="l01202"></a>01202 {
<a name="l01203"></a>01203     <span class="keywordflow">if</span> (d != info.d)
<a name="l01204"></a>01204     {
<a name="l01205"></a>01205         deref();
<a name="l01206"></a>01206         <span class="comment">// first deref the old one</span>
<a name="l01207"></a>01207         d = info.d;
<a name="l01208"></a>01208         <span class="comment">// and now ref the new one</span>
<a name="l01209"></a>01209         ref();
<a name="l01210"></a>01210     }
<a name="l01211"></a>01211     <span class="keywordflow">return</span> *<span class="keyword">this</span>;
<a name="l01212"></a>01212 }
<a name="l01213"></a>01213 
<a name="l01214"></a><a class="code" href="classKFileMetaInfoGroup.html#a11fc4d696dc35037f690e7499580a61f">01214</a> <span class="keywordtype">bool</span> <a class="code" href="classKFileMetaInfoGroup.html#a11fc4d696dc35037f690e7499580a61f" title="Returns true if the item is valid, i.e.">KFileMetaInfoGroup::isValid</a>()<span class="keyword"> const</span>
<a name="l01215"></a>01215 <span class="keyword"></span>{
<a name="l01216"></a>01216     <span class="comment">// We don&#39;t call makeNull here since it isn&#39;t necassery, see deref()</span>
<a name="l01217"></a>01217     <span class="keywordflow">return</span> d != Data::null;
<a name="l01218"></a>01218 }
<a name="l01219"></a>01219 
<a name="l01220"></a><a class="code" href="classKFileMetaInfoGroup.html#a66fc6d39c805f4002d033aa850fe17d7">01220</a> <span class="keywordtype">bool</span> <a class="code" href="classKFileMetaInfoGroup.html#a66fc6d39c805f4002d033aa850fe17d7" title="Returns false if the object contains data, true if it&#39;s empty.">KFileMetaInfoGroup::isEmpty</a>()<span class="keyword"> const</span>
<a name="l01221"></a>01221 <span class="keyword"></span>{
<a name="l01222"></a>01222     <span class="keywordflow">return</span> d-&gt;items.isEmpty();
<a name="l01223"></a>01223 }
<a name="l01224"></a>01224 
<a name="l01225"></a><a class="code" href="classKFileMetaInfoGroup.html#a6f668aa10b55c9fbd127a4401b55ab45">01225</a> <a class="codeRef" href="qstringlist.html">QStringList</a> <a class="code" href="classKFileMetaInfoGroup.html#a6f668aa10b55c9fbd127a4401b55ab45" title="Returns a list of all keys in preference order.">KFileMetaInfoGroup::preferredKeys</a>()<span class="keyword"> const</span>
<a name="l01226"></a>01226 <span class="keyword"></span>{
<a name="l01227"></a>01227     assert(<a class="code" href="classKFileMetaInfoGroup.html#a11fc4d696dc35037f690e7499580a61f" title="Returns true if the item is valid, i.e.">isValid</a>());
<a name="l01228"></a>01228     <a class="codeRef" href="qstringlist.html">QStringList</a> list = <a class="code" href="classKFileMetaInfoGroup.html#ac5138cd5341215050e0196986b687e37" title="Returns a list of all keys.">keys</a>();
<a name="l01229"></a>01229     <a class="codeRef" href="qstringlist.html">QStringList</a> newlist;
<a name="l01230"></a>01230     <a class="codeRef" href="qstringlist.html">QStringList</a> <a class="code" href="classKFileMetaInfoGroup.html#a6f668aa10b55c9fbd127a4401b55ab45" title="Returns a list of all keys in preference order.">preferredKeys</a> = d-&gt;mimeTypeInfo-&gt;preferredKeys();
<a name="l01231"></a>01231     QStringList::Iterator pref;
<a name="l01232"></a>01232     QStringList::Iterator begin = preferredKeys.begin();
<a name="l01233"></a>01233     QStringList::Iterator end   = preferredKeys.end();
<a name="l01234"></a>01234 
<a name="l01235"></a>01235     <span class="comment">// move all keys from the preferred keys that are in our list to a new list</span>
<a name="l01236"></a>01236     <span class="keywordflow">for</span> ( pref = begin; pref!=end; ++pref )
<a name="l01237"></a>01237     {
<a name="l01238"></a>01238         QStringList::Iterator item = list.find(*pref);
<a name="l01239"></a>01239         <span class="keywordflow">if</span> ( item != list.end() )
<a name="l01240"></a>01240         {
<a name="l01241"></a>01241              newlist.append( *item );
<a name="l01242"></a>01242              list.remove(item);
<a name="l01243"></a>01243         }
<a name="l01244"></a>01244     }
<a name="l01245"></a>01245 
<a name="l01246"></a>01246     <span class="comment">// now the old list only contains the non-preferred items, so we</span>
<a name="l01247"></a>01247     <span class="comment">// add the remaining ones to newlist</span>
<a name="l01248"></a>01248     newlist += list;
<a name="l01249"></a>01249 
<a name="l01250"></a>01250     <span class="keywordflow">return</span> newlist;
<a name="l01251"></a>01251 }
<a name="l01252"></a>01252 
<a name="l01253"></a><a class="code" href="classKFileMetaInfoGroup.html#ac5138cd5341215050e0196986b687e37">01253</a> <a class="codeRef" href="qstringlist.html">QStringList</a> <a class="code" href="classKFileMetaInfoGroup.html#ac5138cd5341215050e0196986b687e37" title="Returns a list of all keys.">KFileMetaInfoGroup::keys</a>()<span class="keyword"> const</span>
<a name="l01254"></a>01254 <span class="keyword"></span>{
<a name="l01255"></a>01255     <span class="keywordflow">if</span> (d == Data::makeNull())
<a name="l01256"></a>01256         kdWarning(7033) &lt;&lt; <span class="stringliteral">&quot;attempt to get the keys of &quot;</span>
<a name="l01257"></a>01257                            <span class="stringliteral">&quot;an invalid metainfo group&quot;</span>;
<a name="l01258"></a>01258 
<a name="l01259"></a>01259     <a class="codeRef" href="qstringlist.html">QStringList</a> list;
<a name="l01260"></a>01260 
<a name="l01261"></a>01261     <span class="comment">// make a QStringList with all available keys</span>
<a name="l01262"></a>01262     <a class="codeRef" href="qmapconstiterator.html">QMapConstIterator&lt;QString, KFileMetaInfoItem&gt;</a> it;
<a name="l01263"></a>01263     <span class="keywordflow">for</span> (it = d-&gt;items.begin(); it!=d-&gt;items.end(); ++it)
<a name="l01264"></a>01264     {
<a name="l01265"></a>01265         list.append(it.<a class="codeRef" href="qmapconstiterator.html#data">data</a>().key());
<a name="l01266"></a>01266 <span class="comment">//        kdDebug(7033) &lt;&lt; &quot;Item &quot; &lt;&lt; it.data().key() &lt;&lt; endl;</span>
<a name="l01267"></a>01267     }
<a name="l01268"></a>01268     <span class="keywordflow">return</span> list;
<a name="l01269"></a>01269 }
<a name="l01270"></a>01270 
<a name="l01271"></a><a class="code" href="classKFileMetaInfoGroup.html#a82ef2dfa8f49d1f858a359359b0b1130">01271</a> <a class="codeRef" href="qstring.html">QString</a> <a class="code" href="classKFileMetaInfoGroup.html#a82ef2dfa8f49d1f858a359359b0b1130" title="The translated name of this group.">KFileMetaInfoGroup::translatedName</a>()<span class="keyword"> const</span>
<a name="l01272"></a>01272 <span class="keyword"></span>{
<a name="l01273"></a>01273     assert(<a class="code" href="classKFileMetaInfoGroup.html#a11fc4d696dc35037f690e7499580a61f" title="Returns true if the item is valid, i.e.">isValid</a>());
<a name="l01274"></a>01274     <span class="keywordflow">return</span> d-&gt;mimeTypeInfo-&gt;groupInfo(d-&gt;name)-&gt;translatedName();
<a name="l01275"></a>01275 }
<a name="l01276"></a>01276 
<a name="l01277"></a><a class="code" href="classKFileMetaInfoGroup.html#a9f6f35fb3d37b948e49016ef4b934810">01277</a> <a class="codeRef" href="qstringlist.html">QStringList</a> <a class="code" href="classKFileMetaInfoGroup.html#a9f6f35fb3d37b948e49016ef4b934810" title="Use this method to get a list of keys in the specified group that the plugin knows about...">KFileMetaInfoGroup::supportedKeys</a>()<span class="keyword"> const</span>
<a name="l01278"></a>01278 <span class="keyword"></span>{
<a name="l01279"></a>01279     assert(<a class="code" href="classKFileMetaInfoGroup.html#a11fc4d696dc35037f690e7499580a61f" title="Returns true if the item is valid, i.e.">isValid</a>());
<a name="l01280"></a>01280     <span class="keywordflow">return</span> d-&gt;mimeTypeInfo-&gt;groupInfo(d-&gt;name)-&gt;supportedKeys();
<a name="l01281"></a>01281 }
<a name="l01282"></a>01282 
<a name="l01283"></a><a class="code" href="classKFileMetaInfoGroup.html#a43c0eddb30858348225ef134de7d09e5">01283</a> <span class="keywordtype">bool</span> <a class="code" href="classKFileMetaInfoGroup.html#a43c0eddb30858348225ef134de7d09e5" title="Returns true if this group supports adding or removing arbitrary keys, false if not.">KFileMetaInfoGroup::supportsVariableKeys</a>()<span class="keyword"> const</span>
<a name="l01284"></a>01284 <span class="keyword"></span>{
<a name="l01285"></a>01285     assert(<a class="code" href="classKFileMetaInfoGroup.html#a11fc4d696dc35037f690e7499580a61f" title="Returns true if the item is valid, i.e.">isValid</a>());
<a name="l01286"></a>01286     <span class="keywordflow">return</span> d-&gt;mimeTypeInfo-&gt;groupInfo(d-&gt;name)-&gt;supportsVariableKeys();
<a name="l01287"></a>01287 }
<a name="l01288"></a>01288 
<a name="l01289"></a><a class="code" href="classKFileMetaInfoGroup.html#aa1b5ddd8ed76fc7c48dd36df1a8d957a">01289</a> <span class="keywordtype">bool</span> <a class="code" href="classKFileMetaInfoGroup.html#aa1b5ddd8ed76fc7c48dd36df1a8d957a" title="Checks whether an item with the given key exists.">KFileMetaInfoGroup::contains</a>( <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>&amp; key )<span class="keyword"> const</span>
<a name="l01290"></a>01290 <span class="keyword"></span>{
<a name="l01291"></a>01291     <span class="keywordflow">return</span> d-&gt;items.contains(key);
<a name="l01292"></a>01292 }
<a name="l01293"></a>01293 
<a name="l01294"></a><a class="code" href="classKFileMetaInfoGroup.html#a886e86a71ccad1011c073b15e1be6fe5">01294</a> <a class="code" href="classKFileMetaInfoItem.html" title="A meta information item about a file.">KFileMetaInfoItem</a> <a class="code" href="classKFileMetaInfoGroup.html#a886e86a71ccad1011c073b15e1be6fe5" title="This method searches for the specified item.">KFileMetaInfoGroup::item</a>( <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>&amp; key)<span class="keyword"> const</span>
<a name="l01295"></a>01295 <span class="keyword"></span>{
<a name="l01296"></a>01296     <a class="codeRef" href="qmapiterator.html">QMapIterator&lt;QString,KFileMetaInfoItem&gt;</a> it = d-&gt;items.find( key );
<a name="l01297"></a>01297     <span class="keywordflow">if</span> ( it != d-&gt;items.end() )
<a name="l01298"></a>01298         <span class="keywordflow">return</span> it.<a class="codeRef" href="qmapiterator.html#data">data</a>();
<a name="l01299"></a>01299 
<a name="l01300"></a>01300     <span class="keywordflow">return</span> <a class="code" href="classKFileMetaInfoItem.html" title="A meta information item about a file.">KFileMetaInfoItem</a>();
<a name="l01301"></a>01301 }
<a name="l01302"></a>01302 
<a name="l01303"></a><a class="code" href="classKFileMetaInfoGroup.html#af75ec85cebaf049046ae39372e351c35">01303</a> <a class="code" href="classKFileMetaInfoItem.html" title="A meta information item about a file.">KFileMetaInfoItem</a> <a class="code" href="classKFileMetaInfoGroup.html#a886e86a71ccad1011c073b15e1be6fe5" title="This method searches for the specified item.">KFileMetaInfoGroup::item</a>(uint hint)<span class="keyword"> const</span>
<a name="l01304"></a>01304 <span class="keyword"></span>{
<a name="l01305"></a>01305     <a class="codeRef" href="qmapiterator.html">QMapIterator&lt;QString, KFileMetaInfoItem&gt;</a> it;
<a name="l01306"></a>01306 
<a name="l01307"></a>01307     <span class="keywordflow">for</span> (it = d-&gt;items.begin(); it!=d-&gt;items.end(); ++it)
<a name="l01308"></a>01308         <span class="keywordflow">if</span> (it.<a class="codeRef" href="qmapiterator.html#data">data</a>().hint() == hint)
<a name="l01309"></a>01309             <span class="keywordflow">return</span> it.<a class="codeRef" href="qmapiterator.html#data">data</a>();
<a name="l01310"></a>01310 
<a name="l01311"></a>01311     <span class="keywordflow">return</span> <a class="code" href="classKFileMetaInfoItem.html" title="A meta information item about a file.">KFileMetaInfoItem</a>();
<a name="l01312"></a>01312 }
<a name="l01313"></a>01313 
<a name="l01314"></a><a class="code" href="classKFileMetaInfoGroup.html#ae8c602df4f81c84c8b56dfc5f432c526">01314</a> <a class="codeRef" href="qstring.html">QString</a> <a class="code" href="classKFileMetaInfoGroup.html#ae8c602df4f81c84c8b56dfc5f432c526" title="The name of this group.">KFileMetaInfoGroup::name</a>()<span class="keyword"> const</span>
<a name="l01315"></a>01315 <span class="keyword"></span>{
<a name="l01316"></a>01316     <span class="keywordflow">return</span> d-&gt;name;
<a name="l01317"></a>01317 }
<a name="l01318"></a>01318 
<a name="l01319"></a><a class="code" href="classKFileMetaInfoGroup.html#a4cb973646ae59a76ff2a27556e5a3f37">01319</a> uint <a class="code" href="classKFileMetaInfoGroup.html#a4cb973646ae59a76ff2a27556e5a3f37" title="Returns the attributes of this item.">KFileMetaInfoGroup::attributes</a>()<span class="keyword"> const</span>
<a name="l01320"></a>01320 <span class="keyword"></span>{
<a name="l01321"></a>01321     assert(<a class="code" href="classKFileMetaInfoGroup.html#a11fc4d696dc35037f690e7499580a61f" title="Returns true if the item is valid, i.e.">isValid</a>());
<a name="l01322"></a>01322     <span class="keywordflow">return</span> d-&gt;mimeTypeInfo-&gt;groupInfo(d-&gt;name)-&gt;attributes();
<a name="l01323"></a>01323 }
<a name="l01324"></a>01324 
<a name="l01325"></a>01325 <span class="keywordtype">void</span> KFileMetaInfoGroup::setAdded()
<a name="l01326"></a>01326 {
<a name="l01327"></a>01327     d-&gt;added = <span class="keyword">true</span>;
<a name="l01328"></a>01328 }
<a name="l01329"></a>01329 
<a name="l01330"></a><a class="code" href="classKFileMetaInfoGroup.html#a09df5b569f1bded3f626b443523cf4d2">01330</a> <span class="keywordtype">bool</span> <a class="code" href="classKFileMetaInfoGroup.html#a09df5b569f1bded3f626b443523cf4d2" title="Returns true if an item as added or removed from the group.">KFileMetaInfoGroup::isModified</a>()<span class="keyword"> const</span>
<a name="l01331"></a>01331 <span class="keyword"></span>{
<a name="l01332"></a>01332     <span class="keywordflow">return</span> d-&gt;dirty;
<a name="l01333"></a>01333 }
<a name="l01334"></a>01334 
<a name="l01335"></a>01335 <span class="keywordtype">void</span> KFileMetaInfoGroup::ref()
<a name="l01336"></a>01336 {
<a name="l01337"></a>01337     <span class="keywordflow">if</span> (d != Data::null) d-&gt;ref();
<a name="l01338"></a>01338 
<a name="l01339"></a>01339 }
<a name="l01340"></a>01340 
<a name="l01341"></a>01341 <span class="keywordtype">void</span> KFileMetaInfoGroup::deref()
<a name="l01342"></a>01342 {
<a name="l01343"></a>01343     <span class="comment">// We don&#39;t call makeNull here since it isn&#39;t necassery:</span>
<a name="l01344"></a>01344     <span class="comment">// If d is equal to null it means that null is initialized already.</span>
<a name="l01345"></a>01345     <span class="comment">// null is 0L when it hasn&#39;t been initialized and d is never 0L.</span>
<a name="l01346"></a>01346     <span class="keywordflow">if</span> ((d != Data::null) &amp;&amp; d-&gt;deref())
<a name="l01347"></a>01347     {
<a name="l01348"></a>01348 <span class="comment">//        kdDebug(7033) &lt;&lt; &quot;metainfo group &quot; &lt;&lt; d-&gt;name</span>
<a name="l01349"></a>01349 <span class="comment">//                      &lt;&lt; &quot; is finally deleted\n&quot;;</span>
<a name="l01350"></a>01350         <span class="keyword">delete</span> d;
<a name="l01351"></a>01351         d = 0;
<a name="l01352"></a>01352     }
<a name="l01353"></a>01353 
<a name="l01354"></a>01354 }
<a name="l01355"></a>01355 
<a name="l01356"></a><a class="code" href="classKFileMetaInfoGroup.html#ae401600d5901092c2f753e3ec619bf2b">01356</a> <a class="code" href="classKFileMetaInfoItem.html" title="A meta information item about a file.">KFileMetaInfoItem</a> <a class="code" href="classKFileMetaInfoGroup.html#ae401600d5901092c2f753e3ec619bf2b" title="Add an item to the info.">KFileMetaInfoGroup::addItem</a>( <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>&amp; key )
<a name="l01357"></a>01357 {
<a name="l01358"></a>01358     assert(<a class="code" href="classKFileMetaInfoGroup.html#a11fc4d696dc35037f690e7499580a61f" title="Returns true if the item is valid, i.e.">isValid</a>());
<a name="l01359"></a>01359     <a class="codeRef" href="qmapiterator.html">QMapIterator&lt;QString,KFileMetaInfoItem&gt;</a> it = d-&gt;items.find( key );
<a name="l01360"></a>01360     <span class="keywordflow">if</span> ( it != d-&gt;items.end() )
<a name="l01361"></a>01361         <span class="keywordflow">return</span> it.<a class="codeRef" href="qmapiterator.html#data">data</a>();
<a name="l01362"></a>01362 
<a name="l01363"></a>01363     <span class="keyword">const</span> <a class="code" href="classKFileMimeTypeInfo_1_1GroupInfo.html" title="Information about a meta information group.">KFileMimeTypeInfo::GroupInfo</a>* ginfo = d-&gt;mimeTypeInfo-&gt;groupInfo(d-&gt;name);
<a name="l01364"></a>01364 
<a name="l01365"></a>01365     <span class="keywordflow">if</span> ( !ginfo ) {
<a name="l01366"></a>01366         Q_ASSERT( ginfo );
<a name="l01367"></a>01367         <span class="keywordflow">return</span> <a class="code" href="classKFileMetaInfoItem.html" title="A meta information item about a file.">KFileMetaInfoItem</a>();
<a name="l01368"></a>01368     }
<a name="l01369"></a>01369 
<a name="l01370"></a>01370     <span class="keyword">const</span> <a class="code" href="classKFileMimeTypeInfo_1_1ItemInfo.html" title="This is the class for one item of a KFileMimeTypeInfo.">KFileMimeTypeInfo::ItemInfo</a>* info = ginfo-&gt;<a class="code" href="classKFileMimeTypeInfo_1_1GroupInfo.html#a2c989d3f558e03095b16b2d98847dc2b" title="A group object can contain several item objects (of which you can get the names with supportedKeys() ...">itemInfo</a>(key);
<a name="l01371"></a>01371 
<a name="l01372"></a>01372     <span class="keywordflow">if</span> ( !info ) {
<a name="l01373"></a>01373         Q_ASSERT( info );
<a name="l01374"></a>01374         <span class="keywordflow">return</span> <a class="code" href="classKFileMetaInfoItem.html" title="A meta information item about a file.">KFileMetaInfoItem</a>();
<a name="l01375"></a>01375     }
<a name="l01376"></a>01376 
<a name="l01377"></a>01377     <a class="code" href="classKFileMetaInfoItem.html" title="A meta information item about a file.">KFileMetaInfoItem</a> <a class="code" href="classKFileMetaInfoGroup.html#a886e86a71ccad1011c073b15e1be6fe5" title="This method searches for the specified item.">item</a>;
<a name="l01378"></a>01378 
<a name="l01379"></a>01379     <span class="keywordflow">if</span> (info-&gt;<a class="code" href="classKFileMimeTypeInfo_1_1ItemInfo.html#a17932ed93ac669f38ce2c04b17595d7d" title="Is this item the variable item?">isVariableItem</a>())
<a name="l01380"></a>01380         item = <a class="code" href="classKFileMetaInfoItem.html" title="A meta information item about a file.">KFileMetaInfoItem</a>(ginfo-&gt;<a class="code" href="classKFileMimeTypeInfo_1_1GroupInfo.html#a54563498c720ecfa99a926ac5b9c53ef" title="If the group supports variable keys, you can query their item info with this method.">variableItemInfo</a>(), key, <a class="codeRef" href="qvariant.html">QVariant</a>());
<a name="l01381"></a>01381     <span class="keywordflow">else</span>
<a name="l01382"></a>01382         item = <a class="code" href="classKFileMetaInfoItem.html" title="A meta information item about a file.">KFileMetaInfoItem</a>(info, key, <a class="codeRef" href="qvariant.html">QVariant</a>());
<a name="l01383"></a>01383 
<a name="l01384"></a>01384     d-&gt;items.insert(key, item);
<a name="l01385"></a>01385     item.setAdded();           <span class="comment">// mark as added</span>
<a name="l01386"></a>01386     d-&gt;dirty = <span class="keyword">true</span>;           <span class="comment">// mark ourself as dirty, too</span>
<a name="l01387"></a>01387     <span class="keywordflow">return</span> <a class="code" href="classKFileMetaInfoGroup.html#a886e86a71ccad1011c073b15e1be6fe5" title="This method searches for the specified item.">item</a>;
<a name="l01388"></a>01388 }
<a name="l01389"></a>01389 
<a name="l01390"></a><a class="code" href="classKFileMetaInfoGroup.html#a7cfe51d8f24ba2ebb8a55dd64aaf1ced">01390</a> <span class="keywordtype">bool</span> <a class="code" href="classKFileMetaInfoGroup.html#a7cfe51d8f24ba2ebb8a55dd64aaf1ced" title="Remove this item from the meta info of the file.">KFileMetaInfoGroup::removeItem</a>( <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>&amp; key )
<a name="l01391"></a>01391 {
<a name="l01392"></a>01392     <span class="keywordflow">if</span> (!<a class="code" href="classKFileMetaInfoGroup.html#a11fc4d696dc35037f690e7499580a61f" title="Returns true if the item is valid, i.e.">isValid</a>())
<a name="l01393"></a>01393     {
<a name="l01394"></a>01394           kdDebug(7033) &lt;&lt; <span class="stringliteral">&quot;trying to remove an item from an invalid group\n&quot;</span>;
<a name="l01395"></a>01395           <span class="keywordflow">return</span> <span class="keyword">false</span>;
<a name="l01396"></a>01396     }
<a name="l01397"></a>01397 
<a name="l01398"></a>01398     <a class="codeRef" href="qmapiterator.html">QMapIterator&lt;QString, KFileMetaInfoItem&gt;</a> it = d-&gt;items.find(key);
<a name="l01399"></a>01399     <span class="keywordflow">if</span> ( it==d-&gt;items.end() )
<a name="l01400"></a>01400     {
<a name="l01401"></a>01401           kdDebug(7033) &lt;&lt; <span class="stringliteral">&quot;trying to remove the non existant item &quot;</span> &lt;&lt; key &lt;&lt; <span class="stringliteral">&quot;\n&quot;</span>;
<a name="l01402"></a>01402           <span class="keywordflow">return</span> <span class="keyword">false</span>;
<a name="l01403"></a>01403     }
<a name="l01404"></a>01404 
<a name="l01405"></a>01405     <span class="keywordflow">if</span> (!((*it).attributes() &amp; <a class="code" href="classKFileMimeTypeInfo.html#a5d4779692b425b43302a9a113f91d59aa2f287a0516bbeb007422bbe06142ed38" title="It can be removed.">KFileMimeTypeInfo::Removable</a>))
<a name="l01406"></a>01406     {
<a name="l01407"></a>01407         kdDebug(7033) &lt;&lt; <span class="stringliteral">&quot;trying to remove a non removable item\n&quot;</span>;
<a name="l01408"></a>01408         <span class="keywordflow">return</span> <span class="keyword">false</span>;
<a name="l01409"></a>01409     }
<a name="l01410"></a>01410 
<a name="l01411"></a>01411     (*it).setRemoved();
<a name="l01412"></a>01412     d-&gt;items.remove(it);
<a name="l01413"></a>01413     d-&gt;removedItems.append(key);
<a name="l01414"></a>01414     d-&gt;dirty = <span class="keyword">true</span>;
<a name="l01415"></a>01415     <span class="keywordflow">return</span> <span class="keyword">true</span>;
<a name="l01416"></a>01416 }
<a name="l01417"></a>01417 
<a name="l01418"></a><a class="code" href="classKFileMetaInfoGroup.html#ae421714b0df6f7459dee6766be5bad35">01418</a> <a class="codeRef" href="qstringlist.html">QStringList</a> <a class="code" href="classKFileMetaInfoGroup.html#ae421714b0df6f7459dee6766be5bad35" title="Returns a list of all removed items.">KFileMetaInfoGroup::removedItems</a>()
<a name="l01419"></a>01419 {
<a name="l01420"></a>01420     <span class="keywordflow">return</span> d-&gt;removedItems;
<a name="l01421"></a>01421 }
<a name="l01422"></a>01422 
<a name="l01423"></a>01423 <a class="code" href="classKFileMetaInfoItem.html" title="A meta information item about a file.">KFileMetaInfoItem</a> KFileMetaInfoGroup::appendItem(<span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>&amp; key,
<a name="l01424"></a>01424                                                  <span class="keyword">const</span> <a class="codeRef" href="qvariant.html">QVariant</a>&amp; value)
<a name="l01425"></a>01425 {
<a name="l01426"></a>01426     <span class="comment">//KDE4 enforce (value.type() == d-&gt;mimeTypeInfo-&gt;type())</span>
<a name="l01427"></a>01427     assert(<a class="code" href="classKFileMetaInfoGroup.html#a11fc4d696dc35037f690e7499580a61f" title="Returns true if the item is valid, i.e.">isValid</a>());
<a name="l01428"></a>01428     <span class="keyword">const</span> <a class="code" href="classKFileMimeTypeInfo_1_1GroupInfo.html" title="Information about a meta information group.">KFileMimeTypeInfo::GroupInfo</a>* ginfo = d-&gt;mimeTypeInfo-&gt;groupInfo(d-&gt;name);
<a name="l01429"></a>01429     <span class="keywordflow">if</span> ( !ginfo ) {
<a name="l01430"></a>01430         kdWarning() &lt;&lt; <span class="stringliteral">&quot;Trying to append a Metadata item for a non-existant group:&quot;</span> &lt;&lt; d-&gt;name &lt;&lt; endl;
<a name="l01431"></a>01431         <span class="keywordflow">return</span> <a class="code" href="classKFileMetaInfoItem.html" title="A meta information item about a file.">KFileMetaInfoItem</a>();
<a name="l01432"></a>01432     }
<a name="l01433"></a>01433     <span class="keyword">const</span> <a class="code" href="classKFileMimeTypeInfo_1_1ItemInfo.html" title="This is the class for one item of a KFileMimeTypeInfo.">KFileMimeTypeInfo::ItemInfo</a>* info = ginfo-&gt;<a class="code" href="classKFileMimeTypeInfo_1_1GroupInfo.html#a2c989d3f558e03095b16b2d98847dc2b" title="A group object can contain several item objects (of which you can get the names with supportedKeys() ...">itemInfo</a>(key);
<a name="l01434"></a>01434     <span class="keywordflow">if</span> ( !info ) {
<a name="l01435"></a>01435         kdWarning() &lt;&lt; <span class="stringliteral">&quot;Trying to append a Metadata item for an unknown key (no ItemInfo): &quot;</span> &lt;&lt; key &lt;&lt; endl;
<a name="l01436"></a>01436         <span class="keywordflow">return</span> <a class="code" href="classKFileMetaInfoItem.html" title="A meta information item about a file.">KFileMetaInfoItem</a>();
<a name="l01437"></a>01437     }
<a name="l01438"></a>01438 
<a name="l01439"></a>01439     <a class="code" href="classKFileMetaInfoItem.html" title="A meta information item about a file.">KFileMetaInfoItem</a> <a class="code" href="classKFileMetaInfoGroup.html#a886e86a71ccad1011c073b15e1be6fe5" title="This method searches for the specified item.">item</a>;
<a name="l01440"></a>01440 
<a name="l01441"></a>01441     <span class="keywordflow">if</span> (info-&gt;<a class="code" href="classKFileMimeTypeInfo_1_1ItemInfo.html#ad691d8dd5908a9ef8cde85e20c22df92" title="Returns the name of the item.">key</a>().<a class="codeRef" href="qstring.html#isNull">isNull</a>())
<a name="l01442"></a>01442         item = <a class="code" href="classKFileMetaInfoItem.html" title="A meta information item about a file.">KFileMetaInfoItem</a>(ginfo-&gt;<a class="code" href="classKFileMimeTypeInfo_1_1GroupInfo.html#a54563498c720ecfa99a926ac5b9c53ef" title="If the group supports variable keys, you can query their item info with this method.">variableItemInfo</a>(), key, <a class="code" href="classKFileMetaInfoGroup.html#ac8cedf1668e38a01b45ee11233b1dfc1" title="Convenience function.">value</a>);
<a name="l01443"></a>01443     <span class="keywordflow">else</span>
<a name="l01444"></a>01444         item = <a class="code" href="classKFileMetaInfoItem.html" title="A meta information item about a file.">KFileMetaInfoItem</a>(info, key, value);
<a name="l01445"></a>01445 
<a name="l01446"></a>01446     kdDebug(7033) &lt;&lt; <span class="stringliteral">&quot;KFileMetaInfogroup inserting a &quot;</span> &lt;&lt; key &lt;&lt; endl;
<a name="l01447"></a>01447 
<a name="l01448"></a>01448     d-&gt;items.insert(key, item);
<a name="l01449"></a>01449     <span class="keywordflow">return</span> <a class="code" href="classKFileMetaInfoGroup.html#a886e86a71ccad1011c073b15e1be6fe5" title="This method searches for the specified item.">item</a>;
<a name="l01450"></a>01450 }
<a name="l01451"></a>01451 
<a name="l01452"></a>01452 KFileMetaInfoGroup::Data* KFileMetaInfoGroup::Data::null = 0L;
<a name="l01453"></a>01453 <span class="keyword">static</span> KStaticDeleter&lt;KFileMetaInfoGroup::Data&gt; sd_KFileMetaInfoGroupData;
<a name="l01454"></a>01454 
<a name="l01455"></a>01455 KFileMetaInfoGroup::Data* KFileMetaInfoGroup::Data::makeNull()
<a name="l01456"></a>01456 {
<a name="l01457"></a>01457     <span class="keywordflow">if</span> (!null)
<a name="l01458"></a>01458     {
<a name="l01459"></a>01459         <span class="comment">// We deliberately do not reset &quot;null&quot; after it has been destroyed!</span>
<a name="l01460"></a>01460         <span class="comment">// Otherwise we will run into problems later in ~KFileMetaInfoItem</span>
<a name="l01461"></a>01461         <span class="comment">// where the d-pointer is compared against null.</span>
<a name="l01462"></a>01462         null = <span class="keyword">new</span> Data(QString::null);
<a name="l01463"></a>01463         null-&gt;mimeTypeInfo = <span class="keyword">new</span> <a class="code" href="classKFileMimeTypeInfo.html" title="Represents the capabilities of a KFilePlugin for a given mimetype.">KFileMimeTypeInfo</a>();
<a name="l01464"></a>01464         sd_KFileMetaInfoGroupData.setObject( null );
<a name="l01465"></a>01465     }
<a name="l01466"></a>01466     <span class="keywordflow">return</span> null;
<a name="l01467"></a>01467 }
<a name="l01468"></a>01468 
<a name="l01469"></a>01469 
<a name="l01472"></a>01472 
<a name="l01473"></a>01473 KFileMimeTypeInfo::KFileMimeTypeInfo( <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>&amp; mimeType )
<a name="l01474"></a>01474     : m_mimeType( mimeType )
<a name="l01475"></a>01475 {
<a name="l01476"></a>01476     m_groups.setAutoDelete( <span class="keyword">true</span> );
<a name="l01477"></a>01477 }
<a name="l01478"></a>01478 
<a name="l01479"></a>01479 KFileMimeTypeInfo::~KFileMimeTypeInfo()
<a name="l01480"></a>01480 {
<a name="l01481"></a>01481 }
<a name="l01482"></a>01482 
<a name="l01483"></a><a class="code" href="classKFileMimeTypeInfo.html#af5e86811b49eccac74df74fd52e08ec7">01483</a> <span class="keyword">const</span> <a class="code" href="classKFileMimeTypeInfo_1_1GroupInfo.html" title="Information about a meta information group.">KFileMimeTypeInfo::GroupInfo</a> * <a class="code" href="classKFileMimeTypeInfo.html#af5e86811b49eccac74df74fd52e08ec7" title="Get the group info for a specific group.">KFileMimeTypeInfo::groupInfo</a>( <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>&amp; group )<span class="keyword"> const</span>
<a name="l01484"></a>01484 <span class="keyword"></span>{
<a name="l01485"></a>01485     <span class="keywordflow">return</span> m_groups.<a class="codeRef" href="qdict.html#find">find</a>( group );
<a name="l01486"></a>01486 }
<a name="l01487"></a>01487 
<a name="l01488"></a>01488 <a class="code" href="classKFileMimeTypeInfo_1_1GroupInfo.html" title="Information about a meta information group.">KFileMimeTypeInfo::GroupInfo</a> * KFileMimeTypeInfo::addGroupInfo(
<a name="l01489"></a>01489                            <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>&amp; name, <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>&amp; translatedName )
<a name="l01490"></a>01490 {
<a name="l01491"></a>01491     GroupInfo* group = <span class="keyword">new</span> GroupInfo( name, translatedName );
<a name="l01492"></a>01492     m_groups.<a class="codeRef" href="qdict.html#insert">insert</a>(name, group);
<a name="l01493"></a>01493     <span class="keywordflow">return</span> group;
<a name="l01494"></a>01494 }
<a name="l01495"></a>01495 
<a name="l01496"></a><a class="code" href="classKFileMimeTypeInfo.html#ab5c558904eb0273c5f2f2722fd28dece">01496</a> <a class="codeRef" href="qstringlist.html">QStringList</a> <a class="code" href="classKFileMimeTypeInfo.html#ab5c558904eb0273c5f2f2722fd28dece" title="Returns the list of all groups that the plugin for this mimetype supports.">KFileMimeTypeInfo::supportedGroups</a>()<span class="keyword"> const</span>
<a name="l01497"></a>01497 <span class="keyword"></span>{
<a name="l01498"></a>01498     <a class="codeRef" href="qstringlist.html">QStringList</a> list;
<a name="l01499"></a>01499     <a class="codeRef" href="qdictiterator.html">QDictIterator&lt;GroupInfo&gt;</a> it( m_groups );
<a name="l01500"></a>01500     <span class="keywordflow">for</span> ( ; it.<a class="codeRef" href="qdictiterator.html#current">current</a>(); ++it )
<a name="l01501"></a>01501         list.append( it.<a class="codeRef" href="qdictiterator.html#current">current</a>()-&gt;name() );
<a name="l01502"></a>01502 
<a name="l01503"></a>01503     <span class="keywordflow">return</span> list;
<a name="l01504"></a>01504 }
<a name="l01505"></a>01505 
<a name="l01506"></a><a class="code" href="classKFileMimeTypeInfo.html#ac7589ee8b998657586ec98663bb490d3">01506</a> <a class="codeRef" href="qstringlist.html">QStringList</a> <a class="code" href="classKFileMimeTypeInfo.html#ac7589ee8b998657586ec98663bb490d3" title="Same as the above function, but returns the strings to display to the user.">KFileMimeTypeInfo::translatedGroups</a>()<span class="keyword"> const</span>
<a name="l01507"></a>01507 <span class="keyword"></span>{
<a name="l01508"></a>01508     <a class="codeRef" href="qstringlist.html">QStringList</a> list;
<a name="l01509"></a>01509     <a class="codeRef" href="qdictiterator.html">QDictIterator&lt;GroupInfo&gt;</a> it( m_groups );
<a name="l01510"></a>01510     <span class="keywordflow">for</span> ( ; it.<a class="codeRef" href="qdictiterator.html#current">current</a>(); ++it )
<a name="l01511"></a>01511         list.append( it.<a class="codeRef" href="qdictiterator.html#current">current</a>()-&gt;translatedName() );
<a name="l01512"></a>01512 
<a name="l01513"></a>01513     <span class="keywordflow">return</span> list;
<a name="l01514"></a>01514 }
<a name="l01515"></a>01515 
<a name="l01516"></a><a class="code" href="classKFileMimeTypeInfo.html#ad7cfb08cac0ecbe6b59daa7bcb57e935">01516</a> <a class="codeRef" href="qstringlist.html">QStringList</a> <a class="code" href="classKFileMimeTypeInfo.html#ad7cfb08cac0ecbe6b59daa7bcb57e935" title="Return a list of all supported keys without looking for a specific group.">KFileMimeTypeInfo::supportedKeys</a>()<span class="keyword"> const</span>
<a name="l01517"></a>01517 <span class="keyword"></span>{
<a name="l01518"></a>01518     <span class="comment">// not really efficient, but not those are not large lists, probably.</span>
<a name="l01519"></a>01519     <span class="comment">// maybe cache the result?</span>
<a name="l01520"></a>01520     <a class="codeRef" href="qstringlist.html">QStringList</a> keys;
<a name="l01521"></a>01521     QStringList::ConstIterator lit;
<a name="l01522"></a>01522     <a class="codeRef" href="qdictiterator.html">QDictIterator&lt;GroupInfo&gt;</a> it( m_groups );
<a name="l01523"></a>01523     <span class="keywordflow">for</span> ( ; it.<a class="codeRef" href="qdictiterator.html#current">current</a>(); ++it ) { <span class="comment">// need to nuke dupes</span>
<a name="l01524"></a>01524         <a class="codeRef" href="qstringlist.html">QStringList</a> list = it.<a class="codeRef" href="qdictiterator.html#current">current</a>()-&gt;supportedKeys();
<a name="l01525"></a>01525         <span class="keywordflow">for</span> ( lit = list.begin(); lit != list.end(); ++lit ) {
<a name="l01526"></a>01526             <span class="keywordflow">if</span> ( keys.find( *lit ) == keys.end() )
<a name="l01527"></a>01527                 keys.append( *lit );
<a name="l01528"></a>01528         }
<a name="l01529"></a>01529     }
<a name="l01530"></a>01530 
<a name="l01531"></a>01531     <span class="keywordflow">return</span> keys;
<a name="l01532"></a>01532 }
<a name="l01533"></a>01533 
<a name="l01534"></a><a class="code" href="classKFileMimeTypeInfo.html#a3849955915287b015d3890a4cc3208ff">01534</a> <a class="codeRef" href="qvalidator.html">QValidator</a> * <a class="code" href="classKFileMimeTypeInfo.html#a3849955915287b015d3890a4cc3208ff" title="Creates a validator for this item.">KFileMimeTypeInfo::createValidator</a>(<span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>&amp; group,
<a name="l01535"></a>01535                                                 <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>&amp; key,
<a name="l01536"></a>01536                                                 <a class="codeRef" href="qobject.html">QObject</a> *parent,
<a name="l01537"></a>01537                                                 <span class="keyword">const</span> <span class="keywordtype">char</span> *name)<span class="keyword"> const</span>
<a name="l01538"></a>01538 <span class="keyword"></span>{
<a name="l01539"></a>01539     <a class="code" href="classKFilePlugin.html" title="Base class for a meta information plugin.">KFilePlugin</a>* plugin = KFileMetaInfoProvider::self()-&gt;plugin(m_mimeType);
<a name="l01540"></a>01540     <span class="keywordflow">if</span> (plugin) <span class="keywordflow">return</span> plugin-&gt;<a class="code" href="classKFilePlugin.html#aee0430efca74b86a97a24d3c22757f5b" title="This method should create an appropriate validator for the specified item if it&#39;s editable or return ...">createValidator</a>(<a class="code" href="classKFileMimeTypeInfo.html#a30bece03d3c73904803515fdc06ce6c1" title="Returns the mimetype to which this info belongs.">mimeType</a>(), group, key,
<a name="l01541"></a>01541                                                parent, name);
<a name="l01542"></a>01542     <span class="keywordflow">return</span> 0;
<a name="l01543"></a>01543 }
<a name="l01544"></a>01544 
<a name="l01545"></a>01545 
<a name="l01548"></a>01548 
<a name="l01549"></a>01549 KFileMimeTypeInfo::GroupInfo::GroupInfo( <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>&amp; name,
<a name="l01550"></a>01550                                          <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>&amp; translatedName )
<a name="l01551"></a>01551     : m_name( name ),
<a name="l01552"></a>01552       m_translatedName( translatedName ),
<a name="l01553"></a>01553       m_attr( 0 ),
<a name="l01554"></a>01554       m_variableItemInfo( 0 )
<a name="l01555"></a>01555 
<a name="l01556"></a>01556 {
<a name="l01557"></a>01557     m_itemDict.<a class="codeRef" href="qdict.html#setAutoDelete">setAutoDelete</a>( <span class="keyword">true</span> );
<a name="l01558"></a>01558 }
<a name="l01559"></a>01559 
<a name="l01560"></a>01560 KFileMimeTypeInfo::GroupInfo::~GroupInfo()
<a name="l01561"></a>01561 {
<a name="l01562"></a>01562     <span class="keyword">delete</span> m_variableItemInfo;
<a name="l01563"></a>01563 } 
<a name="l01564"></a>01564 
<a name="l01565"></a><a class="code" href="classKFileMimeTypeInfo_1_1GroupInfo.html#a2c989d3f558e03095b16b2d98847dc2b">01565</a> <span class="keyword">const</span> <a class="code" href="classKFileMimeTypeInfo_1_1ItemInfo.html" title="This is the class for one item of a KFileMimeTypeInfo.">KFileMimeTypeInfo::ItemInfo</a> * <a class="code" href="classKFileMimeTypeInfo_1_1GroupInfo.html#a2c989d3f558e03095b16b2d98847dc2b" title="A group object can contain several item objects (of which you can get the names with supportedKeys() ...">KFileMimeTypeInfo::GroupInfo::itemInfo</a>( <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>&amp; key )<span class="keyword"> const</span>
<a name="l01566"></a>01566 <span class="keyword"></span>{
<a name="l01567"></a>01567     <a class="code" href="classKFileMimeTypeInfo_1_1ItemInfo.html" title="This is the class for one item of a KFileMimeTypeInfo.">ItemInfo</a>* item = m_itemDict.<a class="codeRef" href="qdict.html#find">find</a>( key );
<a name="l01568"></a>01568 
<a name="l01569"></a>01569     <span class="comment">// if we the item isn&#39;t found and variable keys are supported, we need to</span>
<a name="l01570"></a>01570     <span class="comment">// return the default variable key iteminfo.</span>
<a name="l01571"></a>01571     <span class="keywordflow">if</span> (!item &amp;&amp; m_variableItemInfo)
<a name="l01572"></a>01572     {
<a name="l01573"></a>01573         <span class="keywordflow">return</span> m_variableItemInfo;
<a name="l01574"></a>01574     }
<a name="l01575"></a>01575     <span class="keywordflow">return</span> item;
<a name="l01576"></a>01576 }
<a name="l01577"></a>01577 
<a name="l01578"></a>01578 <a class="code" href="classKFileMimeTypeInfo_1_1ItemInfo.html" title="This is the class for one item of a KFileMimeTypeInfo.">KFileMimeTypeInfo::ItemInfo</a>* KFileMimeTypeInfo::GroupInfo::addItemInfo(
<a name="l01579"></a>01579                   <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>&amp; key, <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>&amp; translatedKey,
<a name="l01580"></a>01580                   QVariant::Type type)
<a name="l01581"></a>01581 {
<a name="l01582"></a>01582 <span class="comment">//    kdDebug(7034) &lt;&lt; key &lt;&lt; &quot;(&quot; &lt;&lt; translatedKey &lt;&lt; &quot;) -&gt; &quot; &lt;&lt; QVariant::typeToName(type) &lt;&lt; endl;</span>
<a name="l01583"></a>01583 
<a name="l01584"></a>01584     <a class="code" href="classKFileMimeTypeInfo_1_1ItemInfo.html" title="This is the class for one item of a KFileMimeTypeInfo.">ItemInfo</a>* item = <span class="keyword">new</span> <a class="code" href="classKFileMimeTypeInfo_1_1ItemInfo.html" title="This is the class for one item of a KFileMimeTypeInfo.">ItemInfo</a>(key, translatedKey, type);
<a name="l01585"></a>01585     m_supportedKeys.append(key);
<a name="l01586"></a>01586     m_itemDict.<a class="codeRef" href="qdict.html#insert">insert</a>(key, item);
<a name="l01587"></a>01587     <span class="keywordflow">return</span> item;
<a name="l01588"></a>01588 }
<a name="l01589"></a>01589 
<a name="l01590"></a>01590 
<a name="l01591"></a>01591 <span class="keywordtype">void</span> KFileMimeTypeInfo::GroupInfo::addVariableInfo( QVariant::Type type,
<a name="l01592"></a>01592                                                    uint attr )
<a name="l01593"></a>01593 {
<a name="l01594"></a>01594     <span class="comment">// just make sure that it&#39;s not already there</span>
<a name="l01595"></a>01595     <span class="keyword">delete</span> m_variableItemInfo;
<a name="l01596"></a>01596     m_variableItemInfo = <span class="keyword">new</span> ItemInfo(QString::null, QString::null, type);
<a name="l01597"></a>01597     m_variableItemInfo-&gt;m_attr = attr;
<a name="l01598"></a>01598 }
<a name="l01599"></a>01599 
<a name="l01602"></a>01602 
<a name="l01603"></a><a class="code" href="classKFileMimeTypeInfo_1_1ItemInfo.html#aeaecf27e704d9be847e66cd145cb902b">01603</a> <a class="codeRef" href="qstring.html">QString</a> <a class="code" href="classKFileMimeTypeInfo_1_1ItemInfo.html#aeaecf27e704d9be847e66cd145cb902b" title="Returns a string for the specified value, if possible.">KFileMimeTypeInfo::ItemInfo::string</a>(<span class="keyword">const</span> <a class="codeRef" href="qvariant.html">QVariant</a>&amp; value, <span class="keywordtype">bool</span> mangle)<span class="keyword"> const</span>
<a name="l01604"></a>01604 <span class="keyword"></span>{
<a name="l01605"></a>01605     <a class="codeRef" href="qstring.html">QString</a> s;
<a name="l01606"></a>01606 
<a name="l01607"></a>01607     <span class="keywordflow">switch</span> (value.<a class="codeRef" href="qvariant.html#type">type</a>())
<a name="l01608"></a>01608     {
<a name="l01609"></a>01609         <span class="keywordflow">case</span> QVariant::Invalid :
<a name="l01610"></a>01610             <span class="keywordflow">return</span> <span class="stringliteral">&quot;---&quot;</span>;
<a name="l01611"></a>01611 
<a name="l01612"></a>01612         <span class="keywordflow">case</span> QVariant::Bool :
<a name="l01613"></a>01613             s = value.<a class="codeRef" href="qvariant.html#toBool">toBool</a>() ? i18n(<span class="stringliteral">&quot;Yes&quot;</span>) : i18n(<span class="stringliteral">&quot;No&quot;</span>);
<a name="l01614"></a>01614             <span class="keywordflow">break</span>;
<a name="l01615"></a>01615 
<a name="l01616"></a>01616         <span class="keywordflow">case</span> QVariant::Int :
<a name="l01617"></a>01617             <span class="keywordflow">if</span> (unit() == <a class="code" href="classKFileMimeTypeInfo.html#a9f712056eacff37b74a7da6084590706a166a493323d541ecd4e86b8ca9eef9e8" title="The item represents a time in seconds.">KFileMimeTypeInfo::Seconds</a>)
<a name="l01618"></a>01618             {
<a name="l01619"></a>01619               <span class="keywordtype">int</span> seconds = value.<a class="codeRef" href="qvariant.html#toInt">toInt</a>() % 60;
<a name="l01620"></a>01620               <span class="keywordtype">int</span> minutes = value.<a class="codeRef" href="qvariant.html#toInt">toInt</a>() / 60 % 60;
<a name="l01621"></a>01621               <span class="keywordtype">int</span> hours   = value.<a class="codeRef" href="qvariant.html#toInt">toInt</a>() / 3600;
<a name="l01622"></a>01622               s = hours ? <a class="codeRef" href="qstring.html">QString</a>().<a class="codeRef" href="qstring.html#sprintf">sprintf</a>(<span class="stringliteral">&quot;%d:%02d:%02d&quot;</span>,hours, minutes, seconds)
<a name="l01623"></a>01623                         : <a class="codeRef" href="qstring.html">QString</a>().<a class="codeRef" href="qstring.html#sprintf">sprintf</a>(<span class="stringliteral">&quot;%02d:%02d&quot;</span>, minutes, seconds);
<a name="l01624"></a>01624               <span class="keywordflow">return</span> s; <span class="comment">// no suffix wanted</span>
<a name="l01625"></a>01625             }
<a name="l01626"></a>01626             <span class="keywordflow">else</span> <span class="keywordflow">if</span> (unit() == <a class="code" href="classKFileMimeTypeInfo.html#a9f712056eacff37b74a7da6084590706a8bf087061cbbdc8de3580df5db408ba7" title="Some data/file size in bytes.">KFileMimeTypeInfo::Bytes</a>)
<a name="l01627"></a>01627             {
<a name="l01628"></a>01628                 <span class="comment">// convertSize already adds the correct suffix</span>
<a name="l01629"></a>01629                 <span class="keywordflow">return</span> <a class="code" href="namespaceKIO.html#a350bd897f2425789f4fbd250882700f9" title="Converts size from bytes to the string representation.">KIO::convertSize</a>(value.<a class="codeRef" href="qvariant.html#toInt">toInt</a>());
<a name="l01630"></a>01630             }
<a name="l01631"></a>01631             <span class="keywordflow">else</span> <span class="keywordflow">if</span> (unit() == <a class="code" href="classKFileMimeTypeInfo.html#a9f712056eacff37b74a7da6084590706aabc7d8b4850397b00de94477a937c9d0" title="Some data/file size in kilobytes.">KFileMimeTypeInfo::KiloBytes</a>)
<a name="l01632"></a>01632             {
<a name="l01633"></a>01633                 <span class="comment">// convertSizeFromKB already adds the correct suffix</span>
<a name="l01634"></a>01634                 <span class="keywordflow">return</span> <a class="code" href="namespaceKIO.html#a2bd3a1c75f3bab5d0528aba34ed9f0f7" title="Converts size from kilo-bytes to the string representation.">KIO::convertSizeFromKB</a>(value.<a class="codeRef" href="qvariant.html#toInt">toInt</a>());
<a name="l01635"></a>01635             }
<a name="l01636"></a>01636             <span class="keywordflow">else</span>
<a name="l01637"></a>01637                 s = KGlobal::locale()-&gt;formatNumber( value.<a class="codeRef" href="qvariant.html#toInt">toInt</a>() , 0);
<a name="l01638"></a>01638             <span class="keywordflow">break</span>;
<a name="l01639"></a>01639 
<a name="l01640"></a>01640         <span class="keywordflow">case</span> QVariant::LongLong :
<a name="l01641"></a>01641             s = KGlobal::locale()-&gt;formatNumber( value.<a class="codeRef" href="qvariant.html#toLongLong">toLongLong</a>(), 0 );
<a name="l01642"></a>01642             <span class="keywordflow">break</span>;
<a name="l01643"></a>01643 
<a name="l01644"></a>01644     <span class="keywordflow">case</span> QVariant::ULongLong :
<a name="l01645"></a>01645             <span class="keywordflow">if</span> ( unit() == <a class="code" href="classKFileMimeTypeInfo.html#a9f712056eacff37b74a7da6084590706a8bf087061cbbdc8de3580df5db408ba7" title="Some data/file size in bytes.">KFileMimeTypeInfo::Bytes</a> )
<a name="l01646"></a>01646                 <span class="keywordflow">return</span> <a class="code" href="namespaceKIO.html#a350bd897f2425789f4fbd250882700f9" title="Converts size from bytes to the string representation.">KIO::convertSize</a>( value.<a class="codeRef" href="qvariant.html#toULongLong">toULongLong</a>() );
<a name="l01647"></a>01647             <span class="keywordflow">else</span> <span class="keywordflow">if</span> ( unit() == <a class="code" href="classKFileMimeTypeInfo.html#a9f712056eacff37b74a7da6084590706aabc7d8b4850397b00de94477a937c9d0" title="Some data/file size in kilobytes.">KFileMimeTypeInfo::KiloBytes</a> )
<a name="l01648"></a>01648                 <span class="keywordflow">return</span> <a class="code" href="namespaceKIO.html#a2bd3a1c75f3bab5d0528aba34ed9f0f7" title="Converts size from kilo-bytes to the string representation.">KIO::convertSizeFromKB</a>( value.<a class="codeRef" href="qvariant.html#toULongLong">toULongLong</a>() );
<a name="l01649"></a>01649             <span class="keywordflow">else</span>
<a name="l01650"></a>01650                 s = KGlobal::locale()-&gt;formatNumber( value.<a class="codeRef" href="qvariant.html#toULongLong">toULongLong</a>(), 0 );
<a name="l01651"></a>01651             <span class="keywordflow">break</span>;
<a name="l01652"></a>01652 
<a name="l01653"></a>01653         <span class="keywordflow">case</span> QVariant::UInt :
<a name="l01654"></a>01654             s = KGlobal::locale()-&gt;formatNumber( value.<a class="codeRef" href="qvariant.html#toUInt">toUInt</a>() , 0);
<a name="l01655"></a>01655             <span class="keywordflow">break</span>;
<a name="l01656"></a>01656 
<a name="l01657"></a>01657         <span class="keywordflow">case</span> QVariant::Double :
<a name="l01658"></a>01658             s = KGlobal::locale()-&gt;formatNumber( value.<a class="codeRef" href="qvariant.html#toDouble">toDouble</a>(), 3);
<a name="l01659"></a>01659             <span class="keywordflow">break</span>;
<a name="l01660"></a>01660 
<a name="l01661"></a>01661         <span class="keywordflow">case</span> QVariant::Date :
<a name="l01662"></a>01662             s = KGlobal::locale()-&gt;formatDate( value.<a class="codeRef" href="qvariant.html#toDate">toDate</a>(), true );
<a name="l01663"></a>01663             <span class="keywordflow">break</span>;
<a name="l01664"></a>01664 
<a name="l01665"></a>01665         <span class="keywordflow">case</span> QVariant::Time :
<a name="l01666"></a>01666             s = KGlobal::locale()-&gt;formatTime( value.<a class="codeRef" href="qvariant.html#toTime">toTime</a>(), true );
<a name="l01667"></a>01667             <span class="keywordflow">break</span>;
<a name="l01668"></a>01668 
<a name="l01669"></a>01669         <span class="keywordflow">case</span> QVariant::DateTime :
<a name="l01670"></a>01670             s = KGlobal::locale()-&gt;formatDateTime( value.<a class="codeRef" href="qvariant.html#toDateTime">toDateTime</a>(),
<a name="l01671"></a>01671                                                    <span class="keyword">true</span>, true );
<a name="l01672"></a>01672             <span class="keywordflow">break</span>;
<a name="l01673"></a>01673 
<a name="l01674"></a>01674         <span class="keywordflow">case</span> QVariant::Size :
<a name="l01675"></a>01675             s = <a class="codeRef" href="qstring.html">QString</a>(<span class="stringliteral">&quot;%1 x %2&quot;</span>).<a class="codeRef" href="qstring.html#arg">arg</a>(value.<a class="codeRef" href="qvariant.html#toSize">toSize</a>().width())
<a name="l01676"></a>01676                                 .arg(value.<a class="codeRef" href="qvariant.html#toSize">toSize</a>().height());
<a name="l01677"></a>01677             <span class="keywordflow">break</span>;
<a name="l01678"></a>01678 
<a name="l01679"></a>01679         <span class="keywordflow">case</span> QVariant::Point :
<a name="l01680"></a>01680             s = <a class="codeRef" href="qstring.html">QString</a>(<span class="stringliteral">&quot;%1/%2&quot;</span>).<a class="codeRef" href="qstring.html#arg">arg</a>(value.<a class="codeRef" href="qvariant.html#toSize">toSize</a>().width())
<a name="l01681"></a>01681                                 .arg(value.<a class="codeRef" href="qvariant.html#toSize">toSize</a>().height());
<a name="l01682"></a>01682             <span class="keywordflow">break</span>;
<a name="l01683"></a>01683 
<a name="l01684"></a>01684         <span class="keywordflow">default</span>:
<a name="l01685"></a>01685             s = value.<a class="codeRef" href="qvariant.html#toString">toString</a>();
<a name="l01686"></a>01686     }
<a name="l01687"></a>01687 
<a name="l01688"></a>01688     <span class="keywordflow">if</span> (mangle &amp;&amp; !s.<a class="codeRef" href="qstring.html#isNull">isNull</a>())
<a name="l01689"></a>01689     {
<a name="l01690"></a>01690         s.<a class="codeRef" href="qstring.html#prepend">prepend</a>(prefix());
<a name="l01691"></a>01691         s.<a class="codeRef" href="qstring.html#append">append</a>(<span class="stringliteral">&quot; &quot;</span> + suffix());
<a name="l01692"></a>01692     }
<a name="l01693"></a>01693     <span class="keywordflow">return</span> s;
<a name="l01694"></a>01694 }
<a name="l01695"></a>01695 
<a name="l01696"></a>01696 
<a name="l01699"></a>01699 
<a name="l01700"></a>01700 
<a name="l01701"></a>01701 
<a name="l01702"></a>01702 <span class="comment">// stream operators</span>
<a name="l01703"></a>01703 
<a name="l01704"></a>01704 <span class="comment">/* serialization of a KFileMetaInfoItem:</span>
<a name="l01705"></a>01705 <span class="comment">   first a bool that says if the items is valid, and if yes,</span>
<a name="l01706"></a>01706 <span class="comment">   all the elements of the Data</span>
<a name="l01707"></a>01707 <span class="comment">*/</span>
<a name="l01708"></a>01708 KIO_EXPORT <a class="codeRef" href="qdatastream.html">QDataStream</a>&amp; operator &lt;&lt;(<a class="codeRef" href="qdatastream.html">QDataStream</a>&amp; s, <span class="keyword">const</span> <a class="code" href="classKFileMetaInfoItem.html" title="A meta information item about a file.">KFileMetaInfoItem</a>&amp; item )
<a name="l01709"></a>01709 {
<a name="l01710"></a>01710 
<a name="l01711"></a>01711      KFileMetaInfoItem::Data* d = item.d;
<a name="l01712"></a>01712 
<a name="l01713"></a>01713      <span class="comment">// if the object is invalid, put only a char in the stream</span>
<a name="l01714"></a>01714      <span class="keywordtype">bool</span> isValid = item.<a class="code" href="classKFileMetaInfoItem.html#a94bef8631db1e076ffc0b7c943efb5b7" title="Return true if the item is valid, i.e.">isValid</a>();
<a name="l01715"></a>01715      s &lt;&lt; isValid;
<a name="l01716"></a>01716      <span class="comment">// ### what do about mimetypeInfo ?</span>
<a name="l01717"></a>01717      <span class="keywordflow">if</span> (isValid)
<a name="l01718"></a>01718          s &lt;&lt; d-&gt;key
<a name="l01719"></a>01719            &lt;&lt; d-&gt;value
<a name="l01720"></a>01720            &lt;&lt; d-&gt;dirty
<a name="l01721"></a>01721            &lt;&lt; d-&gt;added
<a name="l01722"></a>01722            &lt;&lt; d-&gt;removed;
<a name="l01723"></a>01723 
<a name="l01724"></a>01724      <span class="keywordflow">return</span> s;
<a name="l01725"></a>01725 }
<a name="l01726"></a>01726 
<a name="l01727"></a>01727 
<a name="l01728"></a>01728 KIO_EXPORT <a class="codeRef" href="qdatastream.html">QDataStream</a>&amp; operator &gt;&gt;(<a class="codeRef" href="qdatastream.html">QDataStream</a>&amp; s, <a class="code" href="classKFileMetaInfoItem.html" title="A meta information item about a file.">KFileMetaInfoItem</a>&amp; item )
<a name="l01729"></a>01729 {
<a name="l01730"></a>01730      <span class="keywordtype">bool</span> isValid;
<a name="l01731"></a>01731      s &gt;&gt; isValid;
<a name="l01732"></a>01732 
<a name="l01733"></a>01733      <span class="keywordflow">if</span> (!isValid)
<a name="l01734"></a>01734      {
<a name="l01735"></a>01735          item = <a class="code" href="classKFileMetaInfoItem.html" title="A meta information item about a file.">KFileMetaInfoItem</a>();
<a name="l01736"></a>01736          <span class="keywordflow">return</span> s;
<a name="l01737"></a>01737      }
<a name="l01738"></a>01738 
<a name="l01739"></a>01739      <span class="comment">// we need a new object for our data</span>
<a name="l01740"></a>01740      item.deref();
<a name="l01741"></a>01741      item.d = <span class="keyword">new</span> KFileMetaInfoItem::Data();
<a name="l01742"></a>01742 
<a name="l01743"></a>01743      <span class="comment">// ### what do about mimetypeInfo ?</span>
<a name="l01744"></a>01744      <span class="keywordtype">bool</span> dirty, added, removed;
<a name="l01745"></a>01745      s &gt;&gt; item.d-&gt;key
<a name="l01746"></a>01746        &gt;&gt; item.d-&gt;value
<a name="l01747"></a>01747        &gt;&gt; dirty
<a name="l01748"></a>01748        &gt;&gt; added
<a name="l01749"></a>01749        &gt;&gt; removed;
<a name="l01750"></a>01750      item.d-&gt;dirty = dirty;
<a name="l01751"></a>01751      item.d-&gt;added = added;
<a name="l01752"></a>01752      item.d-&gt;removed = removed;
<a name="l01753"></a>01753 
<a name="l01754"></a>01754     <span class="keywordflow">return</span> s;
<a name="l01755"></a>01755 }
<a name="l01756"></a>01756 
<a name="l01757"></a>01757 
<a name="l01758"></a>01758 <span class="comment">// serialization of a KFileMetaInfoGroup</span>
<a name="l01759"></a>01759 <span class="comment">// we serialize the name of the mimetype here instead of the mimetype info</span>
<a name="l01760"></a>01760 <span class="comment">// on the other side, we can simply use this to ask the provider for the info</span>
<a name="l01761"></a>01761 KIO_EXPORT <a class="codeRef" href="qdatastream.html">QDataStream</a>&amp; operator &lt;&lt;(<a class="codeRef" href="qdatastream.html">QDataStream</a>&amp; s, <span class="keyword">const</span> <a class="code" href="classKFileMetaInfoGroup.html" title="A group of meta information items about a file.">KFileMetaInfoGroup</a>&amp; group )
<a name="l01762"></a>01762 {
<a name="l01763"></a>01763     KFileMetaInfoGroup::Data* d = group.d;
<a name="l01764"></a>01764 
<a name="l01765"></a>01765     <span class="comment">// if the object is invalid, put only a byte in the stream</span>
<a name="l01766"></a>01766     <span class="keywordtype">bool</span> isValid = group.<a class="code" href="classKFileMetaInfoGroup.html#a11fc4d696dc35037f690e7499580a61f" title="Returns true if the item is valid, i.e.">isValid</a>();
<a name="l01767"></a>01767 
<a name="l01768"></a>01768     s &lt;&lt; isValid;
<a name="l01769"></a>01769     <span class="keywordflow">if</span> (isValid)
<a name="l01770"></a>01770     {
<a name="l01771"></a>01771         s &lt;&lt; d-&gt;name
<a name="l01772"></a>01772           &lt;&lt; d-&gt;items
<a name="l01773"></a>01773           &lt;&lt; d-&gt;mimeTypeInfo-&gt;mimeType();
<a name="l01774"></a>01774     }
<a name="l01775"></a>01775     <span class="keywordflow">return</span> s;
<a name="l01776"></a>01776 }
<a name="l01777"></a>01777 
<a name="l01778"></a>01778 KIO_EXPORT <a class="codeRef" href="qdatastream.html">QDataStream</a>&amp; operator &gt;&gt;(<a class="codeRef" href="qdatastream.html">QDataStream</a>&amp; s, <a class="code" href="classKFileMetaInfoGroup.html" title="A group of meta information items about a file.">KFileMetaInfoGroup</a>&amp; group )
<a name="l01779"></a>01779 {
<a name="l01780"></a>01780     <a class="codeRef" href="qstring.html">QString</a> <a class="code" href="classKFileMimeTypeInfo.html#a30bece03d3c73904803515fdc06ce6c1" title="Returns the mimetype to which this info belongs.">mimeType</a>;
<a name="l01781"></a>01781     <span class="keywordtype">bool</span> isValid;
<a name="l01782"></a>01782     s &gt;&gt; isValid;
<a name="l01783"></a>01783 
<a name="l01784"></a>01784     <span class="comment">// if it&#39;s invalid, there is not much to do</span>
<a name="l01785"></a>01785     <span class="keywordflow">if</span> (!isValid)
<a name="l01786"></a>01786     {
<a name="l01787"></a>01787         group = <a class="code" href="classKFileMetaInfoGroup.html" title="A group of meta information items about a file.">KFileMetaInfoGroup</a>();
<a name="l01788"></a>01788         <span class="keywordflow">return</span> s;
<a name="l01789"></a>01789     }
<a name="l01790"></a>01790 
<a name="l01791"></a>01791     <span class="comment">// we need a new object for our data</span>
<a name="l01792"></a>01792     group.deref();
<a name="l01793"></a>01793     group.d = <span class="keyword">new</span> KFileMetaInfoGroup::Data();
<a name="l01794"></a>01794 
<a name="l01795"></a>01795     s &gt;&gt; group.d-&gt;name
<a name="l01796"></a>01796       &gt;&gt; group.d-&gt;items
<a name="l01797"></a>01797       &gt;&gt; <a class="code" href="classKFileMimeTypeInfo.html#a30bece03d3c73904803515fdc06ce6c1" title="Returns the mimetype to which this info belongs.">mimeType</a>;
<a name="l01798"></a>01798 
<a name="l01799"></a>01799     group.d-&gt;mimeTypeInfo = KFileMetaInfoProvider::self()-&gt;mimeTypeInfo(mimeType);
<a name="l01800"></a>01800 
<a name="l01801"></a>01801     <span class="comment">// we need to set the item info for the items here</span>
<a name="l01802"></a>01802     <a class="codeRef" href="qmapiterator.html">QMapIterator&lt;QString, KFileMetaInfoItem&gt;</a> it = group.d-&gt;items.begin();
<a name="l01803"></a>01803     <span class="keywordflow">for</span> ( ; it != group.d-&gt;items.end(); ++it)
<a name="l01804"></a>01804     {
<a name="l01805"></a>01805         (*it).d-&gt;mimeTypeInfo = group.d-&gt;mimeTypeInfo-&gt;groupInfo(group.d-&gt;name)
<a name="l01806"></a>01806                                   -&gt;itemInfo((*it).key());
<a name="l01807"></a>01807     }
<a name="l01808"></a>01808 
<a name="l01809"></a>01809     <span class="keywordflow">return</span> s;
<a name="l01810"></a>01810 }
<a name="l01811"></a>01811 
<a name="l01812"></a>01812 <span class="comment">// serialization of a KFileMetaInfo object</span>
<a name="l01813"></a>01813 <span class="comment">// we serialize the name of the mimetype here instead of the mimetype info</span>
<a name="l01814"></a>01814 <span class="comment">// on the other side, we can simply use this to ask the provider for the info</span>
<a name="l01815"></a>01815 KIO_EXPORT <a class="codeRef" href="qdatastream.html">QDataStream</a>&amp; operator &lt;&lt;(<a class="codeRef" href="qdatastream.html">QDataStream</a>&amp; s, <span class="keyword">const</span> <a class="code" href="classKFileMetaInfo.html" title="Meta Information about a file.">KFileMetaInfo</a>&amp; info )
<a name="l01816"></a>01816 {
<a name="l01817"></a>01817     KFileMetaInfo::Data* d = info.d;
<a name="l01818"></a>01818 
<a name="l01819"></a>01819     <span class="comment">// if the object is invalid, put only a byte that tells this</span>
<a name="l01820"></a>01820     <span class="keywordtype">bool</span> isValid = info.<a class="code" href="classKFileMetaInfo.html#a7fbb3ea4fc85133d4bd0534f7c684b1e" title="Returns true if the item is valid, i.e.">isValid</a>();
<a name="l01821"></a>01821 
<a name="l01822"></a>01822     s &lt;&lt; isValid;
<a name="l01823"></a>01823     <span class="keywordflow">if</span> (isValid)
<a name="l01824"></a>01824     {
<a name="l01825"></a>01825         s &lt;&lt; d-&gt;url
<a name="l01826"></a>01826           &lt;&lt; d-&gt;what
<a name="l01827"></a>01827           &lt;&lt; d-&gt;groups
<a name="l01828"></a>01828           &lt;&lt; d-&gt;mimeTypeInfo-&gt;mimeType();
<a name="l01829"></a>01829     }
<a name="l01830"></a>01830     <span class="keywordflow">return</span> s;
<a name="l01831"></a>01831 }
<a name="l01832"></a>01832 
<a name="l01833"></a>01833 KIO_EXPORT <a class="codeRef" href="qdatastream.html">QDataStream</a>&amp; operator &gt;&gt;(<a class="codeRef" href="qdatastream.html">QDataStream</a>&amp; s, <a class="code" href="classKFileMetaInfo.html" title="Meta Information about a file.">KFileMetaInfo</a>&amp; info )
<a name="l01834"></a>01834 {
<a name="l01835"></a>01835     <a class="codeRef" href="qstring.html">QString</a> <a class="code" href="classKFileMimeTypeInfo.html#a30bece03d3c73904803515fdc06ce6c1" title="Returns the mimetype to which this info belongs.">mimeType</a>;
<a name="l01836"></a>01836     <span class="keywordtype">bool</span> isValid;
<a name="l01837"></a>01837     s &gt;&gt; isValid;
<a name="l01838"></a>01838 
<a name="l01839"></a>01839     <span class="comment">// if it&#39;s invalid, there is not much to do</span>
<a name="l01840"></a>01840     <span class="keywordflow">if</span> (!isValid)
<a name="l01841"></a>01841     {
<a name="l01842"></a>01842         info = <a class="code" href="classKFileMetaInfo.html" title="Meta Information about a file.">KFileMetaInfo</a>();
<a name="l01843"></a>01843         <span class="keywordflow">return</span> s;
<a name="l01844"></a>01844     }
<a name="l01845"></a>01845 
<a name="l01846"></a>01846     <span class="comment">// we need a new object for our data</span>
<a name="l01847"></a>01847     info.deref();
<a name="l01848"></a>01848     info.d = <span class="keyword">new</span> KFileMetaInfo::Data();
<a name="l01849"></a>01849 
<a name="l01850"></a>01850     s &gt;&gt; info.d-&gt;url
<a name="l01851"></a>01851       &gt;&gt; info.d-&gt;what
<a name="l01852"></a>01852       &gt;&gt; info.d-&gt;groups
<a name="l01853"></a>01853       &gt;&gt; <a class="code" href="classKFileMimeTypeInfo.html#a30bece03d3c73904803515fdc06ce6c1" title="Returns the mimetype to which this info belongs.">mimeType</a>;
<a name="l01854"></a>01854     info.d-&gt;mimeTypeInfo = KFileMetaInfoProvider::self()-&gt;mimeTypeInfo(mimeType);
<a name="l01855"></a>01855 
<a name="l01856"></a>01856     <span class="keywordflow">return</span> s;
<a name="l01857"></a>01857 }
<a name="l01858"></a>01858 
<a name="l01859"></a>01859 <span class="preprocessor">#include &quot;kfilemetainfo.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>kio/kio</h2>
<div class="nav_list">
<ul><li><a href="index.html">Main Page</a></li><li><a href="modules.html">Modules</a></li><li><a href="namespaces.html">Namespace List</a></li><li><a href="hierarchy.html">Class Hierarchy</a></li><li><a href="classes.html">Alphabetical List</a></li><li><a href="annotated.html">Class List</a></li><li><a href="files.html">File List</a></li><li><a href="namespacemembers.html">Namespace Members</a></li><li><a href="functions.html">Class Members</a></li><li><a href="pages.html">Related Pages</a></li></ul>
<!--
<h2>Class Picker</h2>
<div style="text-align: center;">
<form name="guideform">
<select name="guidelinks" style="width:100%;" onChange="window.location=document.guideform.guidelinks.options[document.guideform.guidelinks.selectedIndex].value">
<option value="annotated.html">-- Choose --</option>
  <option value="classKACL.html">kacl</option>,  <option value="classKAr.html">kar</option>,  <option value="classKArchive.html">karchive</option>,  <option value="classKArchiveDirectory.html">karchivedirectory</option>,  <option value="classKArchiveEntry.html">karchiveentry</option>,  <option value="classKArchiveFile.html">karchivefile</option>,  <option value="classKAutoMount.html">kautomount</option>,  <option value="classKAutoUnmount.html">kautounmount</option>,  <option value="classKDataTool.html">kdatatool</option>,  <option value="classKDataToolAction.html">kdatatoolaction</option>,  <option value="classKDataToolInfo.html">kdatatoolinfo</option>,  <option value="classKDCOPServiceStarter.html">kdcopservicestarter</option>,  <option value="classKDEDesktopMimeType.html">kdedesktopmimetype</option>,  <option value="classKDirLister.html">kdirlister</option>,  <option value="classKDirNotify.html">kdirnotify</option>,  <option value="classKDirWatch.html">kdirwatch</option>,  <option value="classKEMailSettings.html">kemailsettings</option>,  <option value="classKExecMimeType.html">kexecmimetype</option>,  <option value="classKFileFilter.html">kfilefilter</option>,  <option value="classKFileItem.html">kfileitem</option>,  <option value="classKFileMetaInfo.html">kfilemetainfo</option>,  <option value="classKFileMetaInfoGroup.html">kfilemetainfogroup</option>,  <option value="classKFileMetaInfoItem.html">kfilemetainfoitem</option>,  <option value="classKFileMimeTypeInfo.html">kfilemimetypeinfo</option>,  <option value="classKFileMimeTypeInfo_1_1GroupInfo.html">kfilemimetypeinfo::groupinfo</option>,  <option value="classKFileMimeTypeInfo_1_1ItemInfo.html">kfilemimetypeinfo::iteminfo</option>,  <option value="classKFilePlugin.html">kfileplugin</option>,  <option value="classKFileShare.html">kfileshare</option>,  <option value="classKFilterBase.html">kfilterbase</option>,  <option value="classKFilterDev.html">kfilterdev</option>,  <option value="classKFolderType.html">kfoldertype</option>,  <option value="classKImageIO.html">kimageio</option>,  <option value="classKIO_1_1AuthInfo.html">kio::authinfo</option>,  <option value="classKIO_1_1ChmodJob.html">kio::chmodjob</option>,  <option value="classKIO_1_1Connection.html">kio::connection</option>,  <option value="classKIO_1_1CopyJob.html">kio::copyjob</option>,  <option value="classKIO_1_1DataProtocol.html">kio::dataprotocol</option>,  <option value="classKIO_1_1DataSlave.html">kio::dataslave</option>,  <option value="classKIO_1_1DavJob.html">kio::davjob</option>,  <option value="classKIO_1_1DeleteJob.html">kio::deletejob</option>,  <option value="classKIO_1_1FileCopyJob.html">kio::filecopyjob</option>,  <option value="classKIO_1_1ForwardingSlaveBase.html">kio::forwardingslavebase</option>,  <option value="classKIO_1_1Job.html">kio::job</option>,  <option value="classKIO_1_1ListJob.html">kio::listjob</option>,  <option value="classKIO_1_1MetaData.html">kio::metadata</option>,  <option value="classKIO_1_1MetaInfoJob.html">kio::metainfojob</option>,  <option value="classKIO_1_1MimetypeJob.html">kio::mimetypejob</option>,  <option value="classKIO_1_1MkdirJob.html">kio::mkdirjob</option>,  <option value="classKIO_1_1MultiGetJob.html">kio::multigetjob</option>,  <option value="classKIO_1_1NetAccess.html">kio::netaccess</option>,  <option value="classKIO_1_1NetRC.html">kio::netrc</option>,  <option value="classKIO_1_1PasswordDialog.html">kio::passworddialog</option>,  <option value="classKIO_1_1PreviewJob.html">kio::previewjob</option>,  <option value="classKIO_1_1ProgressBase.html">kio::progressbase</option>,  <option value="classKIO_1_1RenameDlg.html">kio::renamedlg</option>,  <option value="classKIO_1_1Scheduler.html">kio::scheduler</option>,  <option value="classKIO_1_1SimpleJob.html">kio::simplejob</option>,  <option value="classKIO_1_1Slave.html">kio::slave</option>,  <option value="classKIO_1_1SlaveBase.html">kio::slavebase</option>,  <option value="classKIO_1_1SlaveConfig.html">kio::slaveconfig</option>,  <option value="classKIO_1_1SlaveInterface.html">kio::slaveinterface</option>,  <option value="classKIO_1_1StatJob.html">kio::statjob</option>,  <option value="classKIO_1_1StatusbarProgress.html">kio::statusbarprogress</option>,  <option value="classKIO_1_1StoredTransferJob.html">kio::storedtransferjob</option>,  <option value="classKIO_1_1TCPSlaveBase.html">kio::tcpslavebase</option>,  <option value="classKIO_1_1TransferJob.html">kio::transferjob</option>,  <option value="classKLimitedIODevice.html">klimitediodevice</option>,  <option value="classKMimeMagic.html">kmimemagic</option>,  <option value="classKMimeMagicResult.html">kmimemagicresult</option>,  <option value="classKMimeType.html">kmimetype</option>,  <option value="classKMimeTypeChooser.html">kmimetypechooser</option>,  <option value="classKMimeTypeChooserDialog.html">kmimetypechooserdialog</option>,  <option value="classKMimeTypeResolver.html">kmimetyperesolver</option>,  <option value="classKNFSShare.html">knfsshare</option>,  <option value="classKOCRDialog.html">kocrdialog</option>,  <option value="classKOCRDialogFactory.html">kocrdialogfactory</option>,  <option value="classKOpenWithHandler.html">kopenwithhandler</option>,  <option value="classKProtocolInfo.html">kprotocolinfo</option>,  <option value="classKProtocolManager.html">kprotocolmanager</option>,  <option value="classKRemoteEncoding.html">kremoteencoding</option>,  <option value="classKRun.html">krun</option>,  <option value="classKSambaShare.html">ksambashare</option>,  <option value="classKScanDialog.html">kscandialog</option>,  <option value="classKScanDialogFactory.html">kscandialogfactory</option>,  <option value="classKService.html">kservice</option>,  <option value="classKServiceGroup.html">kservicegroup</option>,  <option value="classKServiceOffer.html">kserviceoffer</option>,  <option value="classKServiceType.html">kservicetype</option>,  <option value="classKServiceTypeProfile.html">kservicetypeprofile</option>,  <option value="classKShellCompletion.html">kshellcompletion</option>,  <option value="classKShred.html">kshred</option>,  <option value="classKSimpleFileFilter.html">ksimplefilefilter</option>,  <option value="classKTar.html">ktar</option>,  <option value="classKTrader.html">ktrader</option>,  <option value="classKURIFilter.html">kurifilter</option>,  <option value="classKURIFilterData.html">kurifilterdata</option>,  <option value="classKURIFilterPlugin.html">kurifilterplugin</option>,  <option value="classKURIFilterPluginList.html">kurifilterpluginlist</option>,  <option value="classKURLCompletion.html">kurlcompletion</option>,  <option value="classKURLPixmapProvider.html">kurlpixmapprovider</option>,  <option value="classKZip.html">kzip</option>,  <option value="classObserver.html">observer</option>,  <option value="classRenameDlgPlugin.html">renamedlgplugin</option>,  <option value="classThumbCreator.html">thumbcreator</option>,
</select>
</form>
</div>
-->
</div></div>
<div class="menu_box"><h2>API Dox</h2>
<div class="nav_list">
<ul>
<li><a href="../../../arts/html/index.html">arts</a></li><li><a href="../../../dcop/html/index.html">dcop</a></li><li><a href="../../../dnssd/html/index.html">dnssd</a></li><li><a href="../../../interfaces/html/index.html">interfaces</a></li><li>&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>