<?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>kdeui: kxmlguiclient.cpp Source File (kdeui)</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=".">kdeui</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">kxmlguiclient.cpp</div> </div>
</div>
<div class="contents">
<div class="fragment"><pre class="fragment"><a name="l00001"></a>00001 <span class="comment">/* This file is part of the KDE libraries</span>
<a name="l00002"></a>00002 <span class="comment"> Copyright (C) 2000 Simon Hausmann <hausmann@kde.org></span>
<a name="l00003"></a>00003 <span class="comment"> Copyright (C) 2000 Kurt Granroth <granroth@kde.org></span>
<a name="l00004"></a>00004 <span class="comment"></span>
<a name="l00005"></a>00005 <span class="comment"> This library is free software; you can redistribute it and/or</span>
<a name="l00006"></a>00006 <span class="comment"> modify it under the terms of the GNU Library General Public</span>
<a name="l00007"></a>00007 <span class="comment"> License version 2 as published by the Free Software Foundation.</span>
<a name="l00008"></a>00008 <span class="comment"></span>
<a name="l00009"></a>00009 <span class="comment"> This library is distributed in the hope that it will be useful,</span>
<a name="l00010"></a>00010 <span class="comment"> but WITHOUT ANY WARRANTY; without even the implied warranty of</span>
<a name="l00011"></a>00011 <span class="comment"> MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU</span>
<a name="l00012"></a>00012 <span class="comment"> Library General Public License for more details.</span>
<a name="l00013"></a>00013 <span class="comment"></span>
<a name="l00014"></a>00014 <span class="comment"> You should have received a copy of the GNU Library General Public License</span>
<a name="l00015"></a>00015 <span class="comment"> along with this library; see the file COPYING.LIB. If not, write to</span>
<a name="l00016"></a>00016 <span class="comment"> the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,</span>
<a name="l00017"></a>00017 <span class="comment"> Boston, MA 02110-1301, USA.</span>
<a name="l00018"></a>00018 <span class="comment">*/</span>
<a name="l00019"></a>00019
<a name="l00020"></a>00020 <span class="preprocessor">#include "kxmlguiclient.h"</span>
<a name="l00021"></a>00021 <span class="preprocessor">#include "kxmlguifactory.h"</span>
<a name="l00022"></a>00022 <span class="preprocessor">#include "kxmlguibuilder.h"</span>
<a name="l00023"></a>00023
<a name="l00024"></a>00024 <span class="preprocessor">#include <qdir.h></span>
<a name="l00025"></a>00025 <span class="preprocessor">#include <qfile.h></span>
<a name="l00026"></a>00026 <span class="preprocessor">#include <qdom.h></span>
<a name="l00027"></a>00027 <span class="preprocessor">#include <qtextstream.h></span>
<a name="l00028"></a>00028 <span class="preprocessor">#include <qregexp.h></span>
<a name="l00029"></a>00029 <span class="preprocessor">#include <qguardedptr.h></span>
<a name="l00030"></a>00030
<a name="l00031"></a>00031 <span class="preprocessor">#include <kinstance.h></span>
<a name="l00032"></a>00032 <span class="preprocessor">#include <kstandarddirs.h></span>
<a name="l00033"></a>00033 <span class="preprocessor">#include <kdebug.h></span>
<a name="l00034"></a>00034 <span class="preprocessor">#include <kaction.h></span>
<a name="l00035"></a>00035 <span class="preprocessor">#include <kapplication.h></span>
<a name="l00036"></a>00036
<a name="l00037"></a>00037 <span class="preprocessor">#include <assert.h></span>
<a name="l00038"></a>00038
<a name="l00039"></a>00039 <span class="keyword">class </span>KXMLGUIClientPrivate
<a name="l00040"></a>00040 {
<a name="l00041"></a>00041 <span class="keyword">public</span>:
<a name="l00042"></a>00042 KXMLGUIClientPrivate()
<a name="l00043"></a>00043 {
<a name="l00044"></a>00044 m_instance = <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/classKGlobal.html#a7005487680376266c61372ea7ff3c080">KGlobal::instance</a>();
<a name="l00045"></a>00045 m_parent = 0L;
<a name="l00046"></a>00046 m_builder = 0L;
<a name="l00047"></a>00047 m_actionCollection = 0;
<a name="l00048"></a>00048 }
<a name="l00049"></a>00049 ~KXMLGUIClientPrivate()
<a name="l00050"></a>00050 {
<a name="l00051"></a>00051 }
<a name="l00052"></a>00052
<a name="l00053"></a>00053 <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/classKInstance.html">KInstance</a> *m_instance;
<a name="l00054"></a>00054
<a name="l00055"></a>00055 <a class="codeRef" href="qdomdocument.html">QDomDocument</a> m_doc;
<a name="l00056"></a>00056 <a class="code" href="classKActionCollection.html" title="A managed set of KAction objects.">KActionCollection</a> *m_actionCollection;
<a name="l00057"></a>00057 <a class="codeRef" href="qdomdocument.html">QDomDocument</a> m_buildDocument;
<a name="l00058"></a>00058 <a class="codeRef" href="qguardedptr.html">QGuardedPtr<KXMLGUIFactory></a> m_factory;
<a name="l00059"></a>00059 <a class="code" href="classKXMLGUIClient.html" title="A KXMLGUIClient can be used with KXMLGUIFactory to create a GUI from actions and an XML document...">KXMLGUIClient</a> *m_parent;
<a name="l00060"></a>00060 <span class="comment">//QPtrList<KXMLGUIClient> m_supers;</span>
<a name="l00061"></a>00061 <a class="codeRef" href="qptrlist.html">QPtrList<KXMLGUIClient></a> m_children;
<a name="l00062"></a>00062 <a class="code" href="classKXMLGUIBuilder.html" title="Abstract interface for a "GUI builder", used by the GUIFactory This interface is implemented by KMain...">KXMLGUIBuilder</a> *m_builder;
<a name="l00063"></a>00063 <a class="codeRef" href="qstring.html">QString</a> m_xmlFile;
<a name="l00064"></a>00064 <a class="codeRef" href="qstring.html">QString</a> m_localXMLFile;
<a name="l00065"></a>00065 };
<a name="l00066"></a>00066
<a name="l00067"></a><a class="code" href="classKXMLGUIClient.html#a3615bc44e8bf87eb93da085a6673d12d">00067</a> <a class="code" href="classKXMLGUIClient.html#a3615bc44e8bf87eb93da085a6673d12d" title="Constructs a KXMLGUIClient which can be used with a KXMLGUIFactory to create a GUI from actions and a...">KXMLGUIClient::KXMLGUIClient</a>()
<a name="l00068"></a>00068 {
<a name="l00069"></a>00069 d = <span class="keyword">new</span> KXMLGUIClientPrivate;
<a name="l00070"></a>00070 }
<a name="l00071"></a>00071
<a name="l00072"></a><a class="code" href="classKXMLGUIClient.html#a94a5e253d2f61f2d73ee26944b34391d">00072</a> <a class="code" href="classKXMLGUIClient.html#a3615bc44e8bf87eb93da085a6673d12d" title="Constructs a KXMLGUIClient which can be used with a KXMLGUIFactory to create a GUI from actions and a...">KXMLGUIClient::KXMLGUIClient</a>( <a class="code" href="classKXMLGUIClient.html" title="A KXMLGUIClient can be used with KXMLGUIFactory to create a GUI from actions and an XML document...">KXMLGUIClient</a> *parent )
<a name="l00073"></a>00073 {
<a name="l00074"></a>00074 d = <span class="keyword">new</span> KXMLGUIClientPrivate;
<a name="l00075"></a>00075 parent-><a class="code" href="classKXMLGUIClient.html#ad5dead4d8da7a6aa7d6bdf258aa43168" title="Use this method to make a client a child client of another client.">insertChildClient</a>( <span class="keyword">this</span> );
<a name="l00076"></a>00076 }
<a name="l00077"></a>00077
<a name="l00078"></a><a class="code" href="classKXMLGUIClient.html#a8efc11a944a5a41bb78e85f070757d1f">00078</a> <a class="code" href="classKXMLGUIClient.html#a8efc11a944a5a41bb78e85f070757d1f" title="Destructs the KXMLGUIClient.">KXMLGUIClient::~KXMLGUIClient</a>()
<a name="l00079"></a>00079 {
<a name="l00080"></a>00080 <span class="keywordflow">if</span> ( d->m_parent )
<a name="l00081"></a>00081 d->m_parent->removeChildClient( <span class="keyword">this</span> );
<a name="l00082"></a>00082
<a name="l00083"></a>00083 <a class="codeRef" href="qptrlistiterator.html">QPtrListIterator<KXMLGUIClient></a> it( d->m_children );
<a name="l00084"></a>00084 <span class="keywordflow">for</span> ( ; it.<a class="codeRef" href="qptrlistiterator.html#current">current</a>(); ++it ) {
<a name="l00085"></a>00085 assert( it.<a class="codeRef" href="qptrlistiterator.html#current">current</a>()->d->m_parent == this );
<a name="l00086"></a>00086 it.<a class="codeRef" href="qptrlistiterator.html#current">current</a>()->d->m_parent = 0;
<a name="l00087"></a>00087 }
<a name="l00088"></a>00088
<a name="l00089"></a>00089 <span class="keyword">delete</span> d->m_actionCollection;
<a name="l00090"></a>00090 <span class="keyword">delete</span> d;
<a name="l00091"></a>00091 }
<a name="l00092"></a>00092
<a name="l00093"></a><a class="code" href="classKXMLGUIClient.html#a1ad7e513dcb1d0526fda4279f60b9fd3">00093</a> <a class="code" href="classKAction.html" title="Class to encapsulate user-driven action or event.">KAction</a> *<a class="code" href="classKXMLGUIClient.html#a1ad7e513dcb1d0526fda4279f60b9fd3" title="Retrieves an action of the client by name.">KXMLGUIClient::action</a>( <span class="keyword">const</span> <span class="keywordtype">char</span> *name )<span class="keyword"> const</span>
<a name="l00094"></a>00094 <span class="keyword"></span>{
<a name="l00095"></a>00095 <a class="code" href="classKAction.html" title="Class to encapsulate user-driven action or event.">KAction</a>* act = <a class="code" href="classKXMLGUIClient.html#a7f996e74cc024ccceb6d96fba355b9a0" title="Retrieves the entire action collection for the GUI client.">actionCollection</a>()-><a class="code" href="classKActionCollection.html#a78b5a9b8e1bd82d6a59fe67501a0fdc8" title="Return the KAction* at position "index" in the action collection.">action</a>( name );
<a name="l00096"></a>00096 <span class="keywordflow">if</span> ( !act ) {
<a name="l00097"></a>00097 <a class="codeRef" href="qptrlistiterator.html">QPtrListIterator<KXMLGUIClient></a> childIt( d->m_children );
<a name="l00098"></a>00098 <span class="keywordflow">for</span> (; childIt.<a class="codeRef" href="qptrlistiterator.html#current">current</a>(); ++childIt ) {
<a name="l00099"></a>00099 act = childIt.<a class="codeRef" href="qptrlistiterator.html#current">current</a>()->actionCollection()->action( name );
<a name="l00100"></a>00100 <span class="keywordflow">if</span> ( act )
<a name="l00101"></a>00101 <span class="keywordflow">break</span>;
<a name="l00102"></a>00102 }
<a name="l00103"></a>00103 }
<a name="l00104"></a>00104 <span class="keywordflow">return</span> act;
<a name="l00105"></a>00105 }
<a name="l00106"></a>00106
<a name="l00107"></a><a class="code" href="classKXMLGUIClient.html#a7f996e74cc024ccceb6d96fba355b9a0">00107</a> <a class="code" href="classKActionCollection.html" title="A managed set of KAction objects.">KActionCollection</a> *<a class="code" href="classKXMLGUIClient.html#a7f996e74cc024ccceb6d96fba355b9a0" title="Retrieves the entire action collection for the GUI client.">KXMLGUIClient::actionCollection</a>()<span class="keyword"> const</span>
<a name="l00108"></a>00108 <span class="keyword"></span>{
<a name="l00109"></a>00109 <span class="keywordflow">if</span> ( !d->m_actionCollection )
<a name="l00110"></a>00110 {
<a name="l00111"></a>00111 d->m_actionCollection = <span class="keyword">new</span> <a class="code" href="classKActionCollection.html" title="A managed set of KAction objects.">KActionCollection</a>(
<a name="l00112"></a>00112 <span class="stringliteral">"KXMLGUIClient-KActionCollection"</span>, <span class="keyword">this</span> );
<a name="l00113"></a>00113 }
<a name="l00114"></a>00114 <span class="keywordflow">return</span> d->m_actionCollection;
<a name="l00115"></a>00115 }
<a name="l00116"></a>00116
<a name="l00117"></a><a class="code" href="classKXMLGUIClient.html#ae95a7e4c168d4cd33f89d1fc9f6093a8">00117</a> <a class="code" href="classKAction.html" title="Class to encapsulate user-driven action or event.">KAction</a> *<a class="code" href="classKXMLGUIClient.html#a1ad7e513dcb1d0526fda4279f60b9fd3" title="Retrieves an action of the client by name.">KXMLGUIClient::action</a>( <span class="keyword">const</span> <a class="codeRef" href="qdomelement.html">QDomElement</a> &element )<span class="keyword"> const</span>
<a name="l00118"></a>00118 <span class="keyword"></span>{
<a name="l00119"></a>00119 <span class="keyword">static</span> <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a> &attrName = <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/classKGlobal.html#a2ec23a16b6d999827c7b523f156cbcbb">KGlobal::staticQString</a>( <span class="stringliteral">"name"</span> );
<a name="l00120"></a>00120 <span class="keywordflow">return</span> <a class="code" href="classKXMLGUIClient.html#a7f996e74cc024ccceb6d96fba355b9a0" title="Retrieves the entire action collection for the GUI client.">actionCollection</a>()-><a class="code" href="classKActionCollection.html#a78b5a9b8e1bd82d6a59fe67501a0fdc8" title="Return the KAction* at position "index" in the action collection.">action</a>( element.<a class="codeRef" href="qdomelement.html#attribute">attribute</a>( attrName ).latin1() );
<a name="l00121"></a>00121 }
<a name="l00122"></a>00122
<a name="l00123"></a><a class="code" href="classKXMLGUIClient.html#a4fd5c48394a44cfe1ca4091bb2bb7523">00123</a> <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/classKInstance.html">KInstance</a> *<a class="code" href="classKXMLGUIClient.html#a4fd5c48394a44cfe1ca4091bb2bb7523">KXMLGUIClient::instance</a>()<span class="keyword"> const</span>
<a name="l00124"></a>00124 <span class="keyword"></span>{
<a name="l00125"></a>00125 <span class="keywordflow">return</span> d->m_instance;
<a name="l00126"></a>00126 }
<a name="l00127"></a>00127
<a name="l00128"></a><a class="code" href="classKXMLGUIClient.html#a169bdeb7a053f630258fb484d5026155">00128</a> <a class="codeRef" href="qdomdocument.html">QDomDocument</a> <a class="code" href="classKXMLGUIClient.html#a169bdeb7a053f630258fb484d5026155">KXMLGUIClient::domDocument</a>()<span class="keyword"> const</span>
<a name="l00129"></a>00129 <span class="keyword"></span>{
<a name="l00130"></a>00130 <span class="keywordflow">return</span> d->m_doc;
<a name="l00131"></a>00131 }
<a name="l00132"></a>00132
<a name="l00133"></a><a class="code" href="classKXMLGUIClient.html#af69761470953d4cd2122108d0440e21b">00133</a> <a class="codeRef" href="qstring.html">QString</a> <a class="code" href="classKXMLGUIClient.html#af69761470953d4cd2122108d0440e21b" title="This will return the name of the XML file as set by setXMLFile().">KXMLGUIClient::xmlFile</a>()<span class="keyword"> const</span>
<a name="l00134"></a>00134 <span class="keyword"></span>{
<a name="l00135"></a>00135 <span class="keywordflow">return</span> d->m_xmlFile;
<a name="l00136"></a>00136 }
<a name="l00137"></a>00137
<a name="l00138"></a>00138 <a class="codeRef" href="qstring.html">QString</a> KXMLGUIClient::localXMLFile()<span class="keyword"> const</span>
<a name="l00139"></a>00139 <span class="keyword"></span>{
<a name="l00140"></a>00140 <span class="keywordflow">if</span> ( !d->m_localXMLFile.isEmpty() )
<a name="l00141"></a>00141 <span class="keywordflow">return</span> d->m_localXMLFile;
<a name="l00142"></a>00142
<a name="l00143"></a>00143 if ( !<a class="codeRef" href="qdir.html#isRelativePath">QDir::isRelativePath</a>(d->m_xmlFile) )
<a name="l00144"></a>00144 <span class="keywordflow">return</span> QString::null; <span class="comment">// can't save anything here</span>
<a name="l00145"></a>00145
<a name="l00146"></a>00146 <span class="keywordflow">return</span> <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/group__locates.html#gaa61f4722cb5eb55a0661b5aec0bbb3fe">locateLocal</a>( <span class="stringliteral">"data"</span>, <a class="codeRef" href="qstring.html#fromLatin1">QString::fromLatin1</a>( <a class="code" href="classKXMLGUIClient.html#a4fd5c48394a44cfe1ca4091bb2bb7523">instance</a>()->instanceName() + <span class="charliteral">'/'</span> ) + d->m_xmlFile );
<a name="l00147"></a>00147 }
<a name="l00148"></a>00148
<a name="l00149"></a>00149
<a name="l00150"></a><a class="code" href="classKXMLGUIClient.html#a4844c3b6a7362cd4dc2e05cc8211d5de">00150</a> <span class="keywordtype">void</span> <a class="code" href="classKXMLGUIClient.html#a4844c3b6a7362cd4dc2e05cc8211d5de" title="Forces this client to re-read its XML resource file.">KXMLGUIClient::reloadXML</a>()
<a name="l00151"></a>00151 {
<a name="l00152"></a>00152 <a class="codeRef" href="qstring.html">QString</a> file( <a class="code" href="classKXMLGUIClient.html#af69761470953d4cd2122108d0440e21b" title="This will return the name of the XML file as set by setXMLFile().">xmlFile</a>() );
<a name="l00153"></a>00153 <span class="keywordflow">if</span> ( !file.<a class="codeRef" href="qstring.html#isEmpty">isEmpty</a>() )
<a name="l00154"></a>00154 <a class="code" href="classKXMLGUIClient.html#a6de555afb77fb964db93d306a5122368" title="Sets the name of the rc file containing the XML for the part.">setXMLFile</a>( file );
<a name="l00155"></a>00155 }
<a name="l00156"></a>00156
<a name="l00157"></a><a class="code" href="classKXMLGUIClient.html#ae7715a5da8f904f17d807638dc3a9758">00157</a> <span class="keywordtype">void</span> <a class="code" href="classKXMLGUIClient.html#ae7715a5da8f904f17d807638dc3a9758" title="Returns true if client was added to super client list.">KXMLGUIClient::setInstance</a>( <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/classKInstance.html">KInstance</a> *instance )
<a name="l00158"></a>00158 {
<a name="l00159"></a>00159 d->m_instance = <a class="code" href="classKXMLGUIClient.html#a4fd5c48394a44cfe1ca4091bb2bb7523">instance</a>;
<a name="l00160"></a>00160 <a class="code" href="classKXMLGUIClient.html#a7f996e74cc024ccceb6d96fba355b9a0" title="Retrieves the entire action collection for the GUI client.">actionCollection</a>()->setInstance( instance );
<a name="l00161"></a>00161 <span class="keywordflow">if</span> ( d->m_builder )
<a name="l00162"></a>00162 d->m_builder->setBuilderClient( <span class="keyword">this</span> );
<a name="l00163"></a>00163 }
<a name="l00164"></a>00164
<a name="l00165"></a><a class="code" href="classKXMLGUIClient.html#a6de555afb77fb964db93d306a5122368">00165</a> <span class="keywordtype">void</span> <a class="code" href="classKXMLGUIClient.html#a6de555afb77fb964db93d306a5122368" title="Sets the name of the rc file containing the XML for the part.">KXMLGUIClient::setXMLFile</a>( <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>& _file, <span class="keywordtype">bool</span> merge, <span class="keywordtype">bool</span> setXMLDoc )
<a name="l00166"></a>00166 {
<a name="l00167"></a>00167 <span class="comment">// store our xml file name</span>
<a name="l00168"></a>00168 <span class="keywordflow">if</span> ( !_file.<a class="codeRef" href="qstring.html#isNull">isNull</a>() ) {
<a name="l00169"></a>00169 d->m_xmlFile = _file;
<a name="l00170"></a>00170 <a class="code" href="classKXMLGUIClient.html#a7f996e74cc024ccceb6d96fba355b9a0" title="Retrieves the entire action collection for the GUI client.">actionCollection</a>()-><a class="code" href="classKActionCollection.html#af8ed067b211b43b29b9a6ceb2b854d88">setXMLFile</a>( _file );
<a name="l00171"></a>00171 }
<a name="l00172"></a>00172
<a name="l00173"></a>00173 <span class="keywordflow">if</span> ( !setXMLDoc )
<a name="l00174"></a>00174 <span class="keywordflow">return</span>;
<a name="l00175"></a>00175
<a name="l00176"></a>00176 <a class="codeRef" href="qstring.html">QString</a> file = _file;
<a name="l00177"></a>00177 <span class="keywordflow">if</span> ( <a class="codeRef" href="qdir.html#isRelativePath">QDir::isRelativePath</a>(file) )
<a name="l00178"></a>00178 {
<a name="l00179"></a>00179 <a class="codeRef" href="qstring.html">QString</a> doc;
<a name="l00180"></a>00180
<a name="l00181"></a>00181 <a class="codeRef" href="qstring.html">QString</a> filter = <a class="codeRef" href="qstring.html#fromLatin1">QString::fromLatin1</a>( <a class="code" href="classKXMLGUIClient.html#a4fd5c48394a44cfe1ca4091bb2bb7523">instance</a>()->instanceName() + <span class="charliteral">'/'</span> ) + _file;
<a name="l00182"></a>00182
<a name="l00183"></a>00183 <a class="codeRef" href="qstringlist.html">QStringList</a> allFiles = <a class="code" href="classKXMLGUIClient.html#a4fd5c48394a44cfe1ca4091bb2bb7523">instance</a>()-><a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/classKInstance.html#a721bf6eba6b89df5581abfb233edefe6">dirs</a>()-><a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/classKStandardDirs.html#ae6310facab4e97b2aceb5cf37080c3c0">findAllResources</a>( <span class="stringliteral">"data"</span>, filter ) + <a class="code" href="classKXMLGUIClient.html#a4fd5c48394a44cfe1ca4091bb2bb7523">instance</a>()-><a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/classKInstance.html#a721bf6eba6b89df5581abfb233edefe6">dirs</a>()-><a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/classKStandardDirs.html#ae6310facab4e97b2aceb5cf37080c3c0">findAllResources</a>( <span class="stringliteral">"data"</span>, _file );
<a name="l00184"></a>00184
<a name="l00185"></a>00185 file = findMostRecentXMLFile( allFiles, doc );
<a name="l00186"></a>00186
<a name="l00187"></a>00187 <span class="keywordflow">if</span> ( file.<a class="codeRef" href="qstring.html#isEmpty">isEmpty</a>() )
<a name="l00188"></a>00188 {
<a name="l00189"></a>00189 <span class="comment">// this might or might not be an error. for the time being,</span>
<a name="l00190"></a>00190 <span class="comment">// let's treat this as if it isn't a problem and the user just</span>
<a name="l00191"></a>00191 <span class="comment">// wants the global standards file</span>
<a name="l00192"></a>00192
<a name="l00193"></a>00193 <span class="comment">// however if a non-empty file gets passed and we can't find it we might</span>
<a name="l00194"></a>00194 <span class="comment">// inform the developer using some debug output</span>
<a name="l00195"></a>00195 <span class="keywordflow">if</span> ( !_file.<a class="codeRef" href="qstring.html#isEmpty">isEmpty</a>() )
<a name="l00196"></a>00196 <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/group__kdebug.html#ga9acd682001598171edf8ecb104fdad2b">kdWarning</a>() << <span class="stringliteral">"KXMLGUIClient::setXMLFile: cannot find .rc file "</span> << _file << <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/group__kdebug.html#ga313d520ed8f8f6b46eeef22cfb3b082a">endl</a>;
<a name="l00197"></a>00197
<a name="l00198"></a>00198 <a class="code" href="classKXMLGUIClient.html#ab6518f2d8705ed69f24fceec4ec88cb3" title="Sets the XML for the part.">setXML</a>( QString::null, <span class="keyword">true</span> );
<a name="l00199"></a>00199 <span class="keywordflow">return</span>;
<a name="l00200"></a>00200 }
<a name="l00201"></a>00201 <span class="keywordflow">else</span> <span class="keywordflow">if</span> ( !doc.<a class="codeRef" href="qstring.html#isEmpty">isEmpty</a>() )
<a name="l00202"></a>00202 {
<a name="l00203"></a>00203 <a class="code" href="classKXMLGUIClient.html#ab6518f2d8705ed69f24fceec4ec88cb3" title="Sets the XML for the part.">setXML</a>( doc, merge );
<a name="l00204"></a>00204 <span class="keywordflow">return</span>;
<a name="l00205"></a>00205 }
<a name="l00206"></a>00206 }
<a name="l00207"></a>00207
<a name="l00208"></a>00208 <a class="codeRef" href="qstring.html">QString</a> xml = KXMLGUIFactory::readConfigFile( file );
<a name="l00209"></a>00209 <a class="code" href="classKXMLGUIClient.html#ab6518f2d8705ed69f24fceec4ec88cb3" title="Sets the XML for the part.">setXML</a>( xml, merge );
<a name="l00210"></a>00210 }
<a name="l00211"></a>00211
<a name="l00212"></a>00212 <span class="keywordtype">void</span> KXMLGUIClient::setLocalXMLFile( <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a> &file )
<a name="l00213"></a>00213 {
<a name="l00214"></a>00214 d->m_localXMLFile = file;
<a name="l00215"></a>00215 }
<a name="l00216"></a>00216
<a name="l00217"></a><a class="code" href="classKXMLGUIClient.html#ab6518f2d8705ed69f24fceec4ec88cb3">00217</a> <span class="keywordtype">void</span> <a class="code" href="classKXMLGUIClient.html#ab6518f2d8705ed69f24fceec4ec88cb3" title="Sets the XML for the part.">KXMLGUIClient::setXML</a>( <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a> &document, <span class="keywordtype">bool</span> merge )
<a name="l00218"></a>00218 {
<a name="l00219"></a>00219 <a class="codeRef" href="qdomdocument.html">QDomDocument</a> doc;
<a name="l00220"></a>00220 doc.<a class="codeRef" href="qdomdocument.html#setContent">setContent</a>( document );
<a name="l00221"></a>00221 <a class="code" href="classKXMLGUIClient.html#a17566d518fa7c2b45f81b85fb8c4fc97" title="Sets the Document for the part, describing the layout of the GUI.">setDOMDocument</a>( doc, merge );
<a name="l00222"></a>00222 }
<a name="l00223"></a>00223
<a name="l00224"></a><a class="code" href="classKXMLGUIClient.html#a17566d518fa7c2b45f81b85fb8c4fc97">00224</a> <span class="keywordtype">void</span> <a class="code" href="classKXMLGUIClient.html#a17566d518fa7c2b45f81b85fb8c4fc97" title="Sets the Document for the part, describing the layout of the GUI.">KXMLGUIClient::setDOMDocument</a>( <span class="keyword">const</span> <a class="codeRef" href="qdomdocument.html">QDomDocument</a> &document, <span class="keywordtype">bool</span> merge )
<a name="l00225"></a>00225 {
<a name="l00226"></a>00226 <span class="keywordflow">if</span> ( merge )
<a name="l00227"></a>00227 {
<a name="l00228"></a>00228 <a class="codeRef" href="qdomelement.html">QDomElement</a> base = d->m_doc.documentElement();
<a name="l00229"></a>00229
<a name="l00230"></a>00230 <a class="codeRef" href="qdomelement.html">QDomElement</a> e = document.<a class="codeRef" href="qdomdocument.html#documentElement">documentElement</a>();
<a name="l00231"></a>00231
<a name="l00232"></a>00232 <span class="comment">// merge our original (global) xml with our new one</span>
<a name="l00233"></a>00233 mergeXML(base, e, <a class="code" href="classKXMLGUIClient.html#a7f996e74cc024ccceb6d96fba355b9a0" title="Retrieves the entire action collection for the GUI client.">actionCollection</a>());
<a name="l00234"></a>00234
<a name="l00235"></a>00235 <span class="comment">// reassign our pointer as mergeXML might have done something</span>
<a name="l00236"></a>00236 <span class="comment">// strange to it</span>
<a name="l00237"></a>00237 base = d->m_doc.documentElement();
<a name="l00238"></a>00238
<a name="l00239"></a>00239 <span class="comment">// we want some sort of failsafe.. just in case</span>
<a name="l00240"></a>00240 <span class="keywordflow">if</span> ( base.isNull() )
<a name="l00241"></a>00241 d->m_doc = document;
<a name="l00242"></a>00242 }
<a name="l00243"></a>00243 <span class="keywordflow">else</span>
<a name="l00244"></a>00244 {
<a name="l00245"></a>00245 d->m_doc = document;
<a name="l00246"></a>00246 }
<a name="l00247"></a>00247
<a name="l00248"></a>00248 <a class="code" href="classKXMLGUIClient.html#a90f952857036d4be2e42657fe4f981bb">setXMLGUIBuildDocument</a>( <a class="codeRef" href="qdomdocument.html">QDomDocument</a>() );
<a name="l00249"></a>00249 }
<a name="l00250"></a>00250
<a name="l00251"></a>00251 <span class="keywordtype">bool</span> KXMLGUIClient::mergeXML( <a class="codeRef" href="qdomelement.html">QDomElement</a> &base, <span class="keyword">const</span> <a class="codeRef" href="qdomelement.html">QDomElement</a> &additive, <a class="code" href="classKActionCollection.html" title="A managed set of KAction objects.">KActionCollection</a> *actionCollection )
<a name="l00252"></a>00252 {
<a name="l00253"></a>00253 <span class="keyword">static</span> <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a> &tagAction = <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/classKGlobal.html#a2ec23a16b6d999827c7b523f156cbcbb">KGlobal::staticQString</a>( <span class="stringliteral">"Action"</span> );
<a name="l00254"></a>00254 <span class="keyword">static</span> <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a> &tagMerge = <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/classKGlobal.html#a2ec23a16b6d999827c7b523f156cbcbb">KGlobal::staticQString</a>( <span class="stringliteral">"Merge"</span> );
<a name="l00255"></a>00255 <span class="keyword">static</span> <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a> &tagSeparator = <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/classKGlobal.html#a2ec23a16b6d999827c7b523f156cbcbb">KGlobal::staticQString</a>( <span class="stringliteral">"Separator"</span> );
<a name="l00256"></a>00256 <span class="keyword">static</span> <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a> &attrName = <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/classKGlobal.html#a2ec23a16b6d999827c7b523f156cbcbb">KGlobal::staticQString</a>( <span class="stringliteral">"name"</span> );
<a name="l00257"></a>00257 <span class="keyword">static</span> <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a> &attrAppend = <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/classKGlobal.html#a2ec23a16b6d999827c7b523f156cbcbb">KGlobal::staticQString</a>( <span class="stringliteral">"append"</span> );
<a name="l00258"></a>00258 <span class="keyword">static</span> <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a> &attrWeakSeparator = <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/classKGlobal.html#a2ec23a16b6d999827c7b523f156cbcbb">KGlobal::staticQString</a>( <span class="stringliteral">"weakSeparator"</span> );
<a name="l00259"></a>00259 <span class="keyword">static</span> <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a> &tagMergeLocal = <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/classKGlobal.html#a2ec23a16b6d999827c7b523f156cbcbb">KGlobal::staticQString</a>( <span class="stringliteral">"MergeLocal"</span> );
<a name="l00260"></a>00260 <span class="keyword">static</span> <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a> &tagText = <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/classKGlobal.html#a2ec23a16b6d999827c7b523f156cbcbb">KGlobal::staticQString</a>( <span class="stringliteral">"text"</span> );
<a name="l00261"></a>00261 <span class="keyword">static</span> <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a> &attrAlreadyVisited = <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/classKGlobal.html#a2ec23a16b6d999827c7b523f156cbcbb">KGlobal::staticQString</a>( <span class="stringliteral">"alreadyVisited"</span> );
<a name="l00262"></a>00262 <span class="keyword">static</span> <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a> &attrNoMerge = <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/classKGlobal.html#a2ec23a16b6d999827c7b523f156cbcbb">KGlobal::staticQString</a>( <span class="stringliteral">"noMerge"</span> );
<a name="l00263"></a>00263 <span class="keyword">static</span> <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a> &attrOne = <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/classKGlobal.html#a2ec23a16b6d999827c7b523f156cbcbb">KGlobal::staticQString</a>( <span class="stringliteral">"1"</span> );
<a name="l00264"></a>00264
<a name="l00265"></a>00265 <span class="comment">// there is a possibility that we don't want to merge in the</span>
<a name="l00266"></a>00266 <span class="comment">// additive.. rather, we might want to *replace* the base with the</span>
<a name="l00267"></a>00267 <span class="comment">// additive. this can be for any container.. either at a file wide</span>
<a name="l00268"></a>00268 <span class="comment">// level or a simple container level. we look for the 'noMerge'</span>
<a name="l00269"></a>00269 <span class="comment">// tag, in any event and just replace the old with the new</span>
<a name="l00270"></a>00270 <span class="keywordflow">if</span> ( additive.<a class="codeRef" href="qdomelement.html#attribute">attribute</a>(attrNoMerge) == attrOne ) <span class="comment">// ### use toInt() instead? (Simon)</span>
<a name="l00271"></a>00271 {
<a name="l00272"></a>00272 base.parentNode().replaceChild(additive, base);
<a name="l00273"></a>00273 <span class="keywordflow">return</span> <span class="keyword">true</span>;
<a name="l00274"></a>00274 }
<a name="l00275"></a>00275
<a name="l00276"></a>00276 <a class="codeRef" href="qstring.html">QString</a> tag;
<a name="l00277"></a>00277
<a name="l00278"></a>00278 <span class="comment">// iterate over all elements in the container (of the global DOM tree)</span>
<a name="l00279"></a>00279 <a class="codeRef" href="qdomnode.html">QDomNode</a> n = base.firstChild();
<a name="l00280"></a>00280 <span class="keywordflow">while</span> ( !n.<a class="codeRef" href="qdomnode.html#isNull">isNull</a>() )
<a name="l00281"></a>00281 {
<a name="l00282"></a>00282 <a class="codeRef" href="qdomelement.html">QDomElement</a> e = n.<a class="codeRef" href="qdomnode.html#toElement">toElement</a>();
<a name="l00283"></a>00283 n = n.<a class="codeRef" href="qdomnode.html#nextSibling">nextSibling</a>(); <span class="comment">// Advance now so that we can safely delete e</span>
<a name="l00284"></a>00284 <span class="keywordflow">if</span> (e.isNull())
<a name="l00285"></a>00285 <span class="keywordflow">continue</span>;
<a name="l00286"></a>00286
<a name="l00287"></a>00287 tag = e.<a class="codeRef" href="qdomelement.html#tagName">tagName</a>();
<a name="l00288"></a>00288
<a name="l00289"></a>00289 <span class="comment">// if there's an action tag in the global tree and the action is</span>
<a name="l00290"></a>00290 <span class="comment">// not implemented, then we remove the element</span>
<a name="l00291"></a>00291 <span class="keywordflow">if</span> ( tag == tagAction )
<a name="l00292"></a>00292 {
<a name="l00293"></a>00293 <a class="codeRef" href="qcstring.html">QCString</a> <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/namespaceKStdAccel.html#a737bc2466b1f000625fe8ebddffbb09d">name</a> = e.<a class="codeRef" href="qdomelement.html#attribute">attribute</a>( attrName ).utf8(); <span class="comment">// WABA</span>
<a name="l00294"></a>00294 <span class="keywordflow">if</span> ( !actionCollection-><a class="code" href="classKActionCollection.html#a78b5a9b8e1bd82d6a59fe67501a0fdc8" title="Return the KAction* at position "index" in the action collection.">action</a>( name ) ||
<a name="l00295"></a>00295 (kapp && !kapp->authorizeKAction(name)))
<a name="l00296"></a>00296 {
<a name="l00297"></a>00297 <span class="comment">// remove this child as we aren't using it</span>
<a name="l00298"></a>00298 base.removeChild( e );
<a name="l00299"></a>00299 <span class="keywordflow">continue</span>;
<a name="l00300"></a>00300 }
<a name="l00301"></a>00301 }
<a name="l00302"></a>00302
<a name="l00303"></a>00303 <span class="comment">// if there's a separator defined in the global tree, then add an</span>
<a name="l00304"></a>00304 <span class="comment">// attribute, specifying that this is a "weak" separator</span>
<a name="l00305"></a>00305 <span class="keywordflow">else</span> <span class="keywordflow">if</span> ( tag == tagSeparator )
<a name="l00306"></a>00306 {
<a name="l00307"></a>00307 e.<a class="codeRef" href="qdomelement.html#setAttribute">setAttribute</a>( attrWeakSeparator, (uint)1 );
<a name="l00308"></a>00308
<a name="l00309"></a>00309 <span class="comment">// okay, hack time. if the last item was a weak separator OR</span>
<a name="l00310"></a>00310 <span class="comment">// this is the first item in a container, then we nuke the</span>
<a name="l00311"></a>00311 <span class="comment">// current one</span>
<a name="l00312"></a>00312 <a class="codeRef" href="qdomelement.html">QDomElement</a> prev = e.previousSibling().toElement();
<a name="l00313"></a>00313 <span class="keywordflow">if</span> ( prev.isNull() ||
<a name="l00314"></a>00314 ( prev.<a class="codeRef" href="qdomelement.html#tagName">tagName</a>() == tagSeparator && !prev.<a class="codeRef" href="qdomelement.html#attribute">attribute</a>( attrWeakSeparator ).isNull() ) ||
<a name="l00315"></a>00315 ( prev.<a class="codeRef" href="qdomelement.html#tagName">tagName</a>() == tagText ) )
<a name="l00316"></a>00316 {
<a name="l00317"></a>00317 <span class="comment">// the previous element was a weak separator or didn't exist</span>
<a name="l00318"></a>00318 base.removeChild( e );
<a name="l00319"></a>00319 <span class="keywordflow">continue</span>;
<a name="l00320"></a>00320 }
<a name="l00321"></a>00321 }
<a name="l00322"></a>00322
<a name="l00323"></a>00323 <span class="comment">// the MergeLocal tag lets us specify where non-standard elements</span>
<a name="l00324"></a>00324 <span class="comment">// of the local tree shall be merged in. After inserting the</span>
<a name="l00325"></a>00325 <span class="comment">// elements we delete this element</span>
<a name="l00326"></a>00326 <span class="keywordflow">else</span> <span class="keywordflow">if</span> ( tag == tagMergeLocal )
<a name="l00327"></a>00327 {
<a name="l00328"></a>00328 <a class="codeRef" href="qdomnode.html">QDomNode</a> it = additive.firstChild();
<a name="l00329"></a>00329 <span class="keywordflow">while</span> ( !it.<a class="codeRef" href="qdomnode.html#isNull">isNull</a>() )
<a name="l00330"></a>00330 {
<a name="l00331"></a>00331 <a class="codeRef" href="qdomelement.html">QDomElement</a> newChild = it.<a class="codeRef" href="qdomnode.html#toElement">toElement</a>();
<a name="l00332"></a>00332 it = it.<a class="codeRef" href="qdomnode.html#nextSibling">nextSibling</a>();
<a name="l00333"></a>00333 <span class="keywordflow">if</span> (newChild.isNull() )
<a name="l00334"></a>00334 <span class="keywordflow">continue</span>;
<a name="l00335"></a>00335
<a name="l00336"></a>00336 <span class="keywordflow">if</span> ( newChild.<a class="codeRef" href="qdomelement.html#tagName">tagName</a>() == tagText )
<a name="l00337"></a>00337 <span class="keywordflow">continue</span>;
<a name="l00338"></a>00338
<a name="l00339"></a>00339 <span class="keywordflow">if</span> ( newChild.<a class="codeRef" href="qdomelement.html#attribute">attribute</a>( attrAlreadyVisited ) == attrOne )
<a name="l00340"></a>00340 <span class="keywordflow">continue</span>;
<a name="l00341"></a>00341
<a name="l00342"></a>00342 <a class="codeRef" href="qstring.html">QString</a> itAppend( newChild.<a class="codeRef" href="qdomelement.html#attribute">attribute</a>( attrAppend ) );
<a name="l00343"></a>00343 <a class="codeRef" href="qstring.html">QString</a> elemName( e.<a class="codeRef" href="qdomelement.html#attribute">attribute</a>( attrName ) );
<a name="l00344"></a>00344
<a name="l00345"></a>00345 <span class="keywordflow">if</span> ( ( itAppend.isNull() && elemName.isEmpty() ) ||
<a name="l00346"></a>00346 ( itAppend == elemName ) )
<a name="l00347"></a>00347 {
<a name="l00348"></a>00348 <span class="comment">// first, see if this new element matches a standard one in</span>
<a name="l00349"></a>00349 <span class="comment">// the global file. if it does, then we skip it as it will</span>
<a name="l00350"></a>00350 <span class="comment">// be merged in, later</span>
<a name="l00351"></a>00351 <a class="codeRef" href="qdomelement.html">QDomElement</a> matchingElement = findMatchingElement( newChild, base );
<a name="l00352"></a>00352 <span class="keywordflow">if</span> ( matchingElement.isNull() || newChild.<a class="codeRef" href="qdomelement.html#tagName">tagName</a>() == tagSeparator )
<a name="l00353"></a>00353 base.insertBefore( newChild, e );
<a name="l00354"></a>00354 }
<a name="l00355"></a>00355 }
<a name="l00356"></a>00356
<a name="l00357"></a>00357 base.removeChild( e );
<a name="l00358"></a>00358 <span class="keywordflow">continue</span>;
<a name="l00359"></a>00359 }
<a name="l00360"></a>00360
<a name="l00361"></a>00361 <span class="comment">// in this last case we check for a separator tag and, if not, we</span>
<a name="l00362"></a>00362 <span class="comment">// can be sure that its a container --> proceed with child nodes</span>
<a name="l00363"></a>00363 <span class="comment">// recursively and delete the just proceeded container item in</span>
<a name="l00364"></a>00364 <span class="comment">// case its empty (if the recursive call returns true)</span>
<a name="l00365"></a>00365 <span class="keywordflow">else</span> <span class="keywordflow">if</span> ( tag != tagMerge )
<a name="l00366"></a>00366 {
<a name="l00367"></a>00367 <span class="comment">// handle the text tag</span>
<a name="l00368"></a>00368 <span class="keywordflow">if</span> ( tag == tagText )
<a name="l00369"></a>00369 <span class="keywordflow">continue</span>;
<a name="l00370"></a>00370
<a name="l00371"></a>00371 <a class="codeRef" href="qdomelement.html">QDomElement</a> matchingElement = findMatchingElement( e, additive );
<a name="l00372"></a>00372
<a name="l00373"></a>00373 <span class="keywordflow">if</span> ( !matchingElement.isNull() )
<a name="l00374"></a>00374 {
<a name="l00375"></a>00375 matchingElement.<a class="codeRef" href="qdomelement.html#setAttribute">setAttribute</a>( attrAlreadyVisited, (uint)1 );
<a name="l00376"></a>00376
<a name="l00377"></a>00377 <span class="keywordflow">if</span> ( mergeXML( e, matchingElement, actionCollection ) )
<a name="l00378"></a>00378 {
<a name="l00379"></a>00379 base.removeChild( e );
<a name="l00380"></a>00380 <span class="keywordflow">continue</span>;
<a name="l00381"></a>00381 }
<a name="l00382"></a>00382
<a name="l00383"></a>00383 <span class="comment">// Merge attributes</span>
<a name="l00384"></a>00384 <span class="keyword">const</span> <a class="codeRef" href="qdomnamednodemap.html">QDomNamedNodeMap</a> attribs = matchingElement.<a class="codeRef" href="qdomelement.html#attributes">attributes</a>();
<a name="l00385"></a>00385 <span class="keyword">const</span> uint attribcount = attribs.<a class="codeRef" href="qdomnamednodemap.html#count">count</a>();
<a name="l00386"></a>00386
<a name="l00387"></a>00387 <span class="keywordflow">for</span>(uint i = 0; i < attribcount; ++i)
<a name="l00388"></a>00388 {
<a name="l00389"></a>00389 <span class="keyword">const</span> <a class="codeRef" href="qdomnode.html">QDomNode</a> node = attribs.<a class="codeRef" href="qdomnamednodemap.html#item">item</a>(i);
<a name="l00390"></a>00390 e.<a class="codeRef" href="qdomelement.html#setAttribute">setAttribute</a>(node.<a class="codeRef" href="qdomnode.html#nodeName">nodeName</a>(), node.<a class="codeRef" href="qdomnode.html#nodeValue">nodeValue</a>());
<a name="l00391"></a>00391 }
<a name="l00392"></a>00392
<a name="l00393"></a>00393 <span class="keywordflow">continue</span>;
<a name="l00394"></a>00394 }
<a name="l00395"></a>00395 <span class="keywordflow">else</span>
<a name="l00396"></a>00396 {
<a name="l00397"></a>00397 <span class="comment">// this is an important case here! We reach this point if the</span>
<a name="l00398"></a>00398 <span class="comment">// "local" tree does not contain a container definition for</span>
<a name="l00399"></a>00399 <span class="comment">// this container. However we have to call mergeXML recursively</span>
<a name="l00400"></a>00400 <span class="comment">// and make it check if there are actions implemented for this</span>
<a name="l00401"></a>00401 <span class="comment">// container. *If* none, then we can remove this container now</span>
<a name="l00402"></a>00402 <span class="keywordflow">if</span> ( mergeXML( e, <a class="codeRef" href="qdomelement.html">QDomElement</a>(), actionCollection ) )
<a name="l00403"></a>00403 base.removeChild( e );
<a name="l00404"></a>00404 <span class="keywordflow">continue</span>;
<a name="l00405"></a>00405 }
<a name="l00406"></a>00406 }
<a name="l00407"></a>00407 }
<a name="l00408"></a>00408
<a name="l00409"></a>00409 <span class="comment">//here we append all child elements which were not inserted</span>
<a name="l00410"></a>00410 <span class="comment">//previously via the LocalMerge tag</span>
<a name="l00411"></a>00411 n = additive.firstChild();
<a name="l00412"></a>00412 <span class="keywordflow">while</span> ( !n.<a class="codeRef" href="qdomnode.html#isNull">isNull</a>() )
<a name="l00413"></a>00413 {
<a name="l00414"></a>00414 <a class="codeRef" href="qdomelement.html">QDomElement</a> e = n.<a class="codeRef" href="qdomnode.html#toElement">toElement</a>();
<a name="l00415"></a>00415 n = n.<a class="codeRef" href="qdomnode.html#nextSibling">nextSibling</a>(); <span class="comment">// Advance now so that we can safely delete e</span>
<a name="l00416"></a>00416 <span class="keywordflow">if</span> (e.isNull())
<a name="l00417"></a>00417 <span class="keywordflow">continue</span>;
<a name="l00418"></a>00418
<a name="l00419"></a>00419 <a class="codeRef" href="qdomelement.html">QDomElement</a> matchingElement = findMatchingElement( e, base );
<a name="l00420"></a>00420
<a name="l00421"></a>00421 <span class="keywordflow">if</span> ( matchingElement.isNull() )
<a name="l00422"></a>00422 {
<a name="l00423"></a>00423 base.appendChild( e );
<a name="l00424"></a>00424 }
<a name="l00425"></a>00425 }
<a name="l00426"></a>00426
<a name="l00427"></a>00427 <span class="comment">// do one quick check to make sure that the last element was not</span>
<a name="l00428"></a>00428 <span class="comment">// a weak separator</span>
<a name="l00429"></a>00429 <a class="codeRef" href="qdomelement.html">QDomElement</a> last = base.lastChild().toElement();
<a name="l00430"></a>00430 <span class="keywordflow">if</span> ( (last.<a class="codeRef" href="qdomelement.html#tagName">tagName</a>() == tagSeparator) && (!last.<a class="codeRef" href="qdomelement.html#attribute">attribute</a>( attrWeakSeparator ).isNull()) )
<a name="l00431"></a>00431 {
<a name="l00432"></a>00432 base.removeChild( last );
<a name="l00433"></a>00433 }
<a name="l00434"></a>00434
<a name="l00435"></a>00435 <span class="comment">// now we check if we are empty (in which case we return "true", to</span>
<a name="l00436"></a>00436 <span class="comment">// indicate the caller that it can delete "us" (the base element</span>
<a name="l00437"></a>00437 <span class="comment">// argument of "this" call)</span>
<a name="l00438"></a>00438 <span class="keywordtype">bool</span> deleteMe = <span class="keyword">true</span>;
<a name="l00439"></a>00439
<a name="l00440"></a>00440 n = base.firstChild();
<a name="l00441"></a>00441 <span class="keywordflow">while</span> ( !n.<a class="codeRef" href="qdomnode.html#isNull">isNull</a>() )
<a name="l00442"></a>00442 {
<a name="l00443"></a>00443 <a class="codeRef" href="qdomelement.html">QDomElement</a> e = n.<a class="codeRef" href="qdomnode.html#toElement">toElement</a>();
<a name="l00444"></a>00444 n = n.<a class="codeRef" href="qdomnode.html#nextSibling">nextSibling</a>(); <span class="comment">// Advance now so that we can safely delete e</span>
<a name="l00445"></a>00445 <span class="keywordflow">if</span> (e.isNull())
<a name="l00446"></a>00446 <span class="keywordflow">continue</span>;
<a name="l00447"></a>00447
<a name="l00448"></a>00448 tag = e.<a class="codeRef" href="qdomelement.html#tagName">tagName</a>();
<a name="l00449"></a>00449
<a name="l00450"></a>00450 <span class="keywordflow">if</span> ( tag == tagAction )
<a name="l00451"></a>00451 {
<a name="l00452"></a>00452 <span class="comment">// if base contains an implemented action, then we must not get</span>
<a name="l00453"></a>00453 <span class="comment">// deleted (note that the actionCollection contains both,</span>
<a name="l00454"></a>00454 <span class="comment">// "global" and "local" actions</span>
<a name="l00455"></a>00455 <span class="keywordflow">if</span> ( actionCollection-><a class="code" href="classKActionCollection.html#a78b5a9b8e1bd82d6a59fe67501a0fdc8" title="Return the KAction* at position "index" in the action collection.">action</a>( e.<a class="codeRef" href="qdomelement.html#attribute">attribute</a>( attrName ).utf8() ) )
<a name="l00456"></a>00456 {
<a name="l00457"></a>00457 deleteMe = <span class="keyword">false</span>;
<a name="l00458"></a>00458 <span class="keywordflow">break</span>;
<a name="l00459"></a>00459 }
<a name="l00460"></a>00460 }
<a name="l00461"></a>00461 <span class="keywordflow">else</span> <span class="keywordflow">if</span> ( tag == tagSeparator )
<a name="l00462"></a>00462 {
<a name="l00463"></a>00463 <span class="comment">// if we have a separator which has *not* the weak attribute</span>
<a name="l00464"></a>00464 <span class="comment">// set, then it must be owned by the "local" tree in which case</span>
<a name="l00465"></a>00465 <span class="comment">// we must not get deleted either</span>
<a name="l00466"></a>00466 <a class="codeRef" href="qstring.html">QString</a> weakAttr = e.<a class="codeRef" href="qdomelement.html#attribute">attribute</a>( attrWeakSeparator );
<a name="l00467"></a>00467 <span class="keywordflow">if</span> ( weakAttr.<a class="codeRef" href="qstring.html#isEmpty">isEmpty</a>() || weakAttr.<a class="codeRef" href="qstring.html#toInt">toInt</a>() != 1 )
<a name="l00468"></a>00468 {
<a name="l00469"></a>00469 deleteMe = <span class="keyword">false</span>;
<a name="l00470"></a>00470 <span class="keywordflow">break</span>;
<a name="l00471"></a>00471 }
<a name="l00472"></a>00472 }
<a name="l00473"></a>00473
<a name="l00474"></a>00474 <span class="comment">// in case of a merge tag we have unlimited lives, too ;-)</span>
<a name="l00475"></a>00475 <span class="keywordflow">else</span> <span class="keywordflow">if</span> ( tag == tagMerge )
<a name="l00476"></a>00476 {
<a name="l00477"></a>00477 <span class="comment">// deleteMe = false;</span>
<a name="l00478"></a>00478 <span class="comment">// break;</span>
<a name="l00479"></a>00479 <span class="keywordflow">continue</span>;
<a name="l00480"></a>00480 }
<a name="l00481"></a>00481
<a name="l00482"></a>00482 <span class="comment">// a text tag is NOT enough to spare this container</span>
<a name="l00483"></a>00483 <span class="keywordflow">else</span> <span class="keywordflow">if</span> ( tag == tagText )
<a name="l00484"></a>00484 {
<a name="l00485"></a>00485 <span class="keywordflow">continue</span>;
<a name="l00486"></a>00486 }
<a name="l00487"></a>00487
<a name="l00488"></a>00488 <span class="comment">// what's left are non-empty containers! *don't* delete us in this</span>
<a name="l00489"></a>00489 <span class="comment">// case (at this position we can be *sure* that the container is</span>
<a name="l00490"></a>00490 <span class="comment">// *not* empty, as the recursive call for it was in the first loop</span>
<a name="l00491"></a>00491 <span class="comment">// which deleted the element in case the call returned "true"</span>
<a name="l00492"></a>00492 <span class="keywordflow">else</span>
<a name="l00493"></a>00493 {
<a name="l00494"></a>00494 deleteMe = <span class="keyword">false</span>;
<a name="l00495"></a>00495 <span class="keywordflow">break</span>;
<a name="l00496"></a>00496 }
<a name="l00497"></a>00497 }
<a name="l00498"></a>00498
<a name="l00499"></a>00499 <span class="keywordflow">return</span> deleteMe;
<a name="l00500"></a>00500 }
<a name="l00501"></a>00501
<a name="l00502"></a>00502 <a class="codeRef" href="qdomelement.html">QDomElement</a> KXMLGUIClient::findMatchingElement( <span class="keyword">const</span> <a class="codeRef" href="qdomelement.html">QDomElement</a> &base, <span class="keyword">const</span> <a class="codeRef" href="qdomelement.html">QDomElement</a> &additive )
<a name="l00503"></a>00503 {
<a name="l00504"></a>00504 <span class="keyword">static</span> <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a> &tagAction = <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/classKGlobal.html#a2ec23a16b6d999827c7b523f156cbcbb">KGlobal::staticQString</a>( <span class="stringliteral">"Action"</span> );
<a name="l00505"></a>00505 <span class="keyword">static</span> <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a> &tagMergeLocal = <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/classKGlobal.html#a2ec23a16b6d999827c7b523f156cbcbb">KGlobal::staticQString</a>( <span class="stringliteral">"MergeLocal"</span> );
<a name="l00506"></a>00506 <span class="keyword">static</span> <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a> &attrName = <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/classKGlobal.html#a2ec23a16b6d999827c7b523f156cbcbb">KGlobal::staticQString</a>( <span class="stringliteral">"name"</span> );
<a name="l00507"></a>00507
<a name="l00508"></a>00508 <a class="codeRef" href="qdomnode.html">QDomNode</a> n = additive.firstChild();
<a name="l00509"></a>00509 <span class="keywordflow">while</span> ( !n.<a class="codeRef" href="qdomnode.html#isNull">isNull</a>() )
<a name="l00510"></a>00510 {
<a name="l00511"></a>00511 <a class="codeRef" href="qdomelement.html">QDomElement</a> e = n.<a class="codeRef" href="qdomnode.html#toElement">toElement</a>();
<a name="l00512"></a>00512 n = n.<a class="codeRef" href="qdomnode.html#nextSibling">nextSibling</a>(); <span class="comment">// Advance now so that we can safely delete e</span>
<a name="l00513"></a>00513 <span class="keywordflow">if</span> (e.isNull())
<a name="l00514"></a>00514 <span class="keywordflow">continue</span>;
<a name="l00515"></a>00515
<a name="l00516"></a>00516 <span class="comment">// skip all action and merge tags as we will never use them</span>
<a name="l00517"></a>00517 <span class="keywordflow">if</span> ( ( e.<a class="codeRef" href="qdomelement.html#tagName">tagName</a>() == tagAction ) || ( e.<a class="codeRef" href="qdomelement.html#tagName">tagName</a>() == tagMergeLocal ) )
<a name="l00518"></a>00518 {
<a name="l00519"></a>00519 <span class="keywordflow">continue</span>;
<a name="l00520"></a>00520 }
<a name="l00521"></a>00521
<a name="l00522"></a>00522 <span class="comment">// now see if our tags are equivalent</span>
<a name="l00523"></a>00523 <span class="keywordflow">if</span> ( ( e.<a class="codeRef" href="qdomelement.html#tagName">tagName</a>() == base.<a class="codeRef" href="qdomelement.html#tagName">tagName</a>() ) &&
<a name="l00524"></a>00524 ( e.<a class="codeRef" href="qdomelement.html#attribute">attribute</a>( attrName ) == base.<a class="codeRef" href="qdomelement.html#attribute">attribute</a>( attrName ) ) )
<a name="l00525"></a>00525 {
<a name="l00526"></a>00526 <span class="keywordflow">return</span> e;
<a name="l00527"></a>00527 }
<a name="l00528"></a>00528 }
<a name="l00529"></a>00529
<a name="l00530"></a>00530 <span class="comment">// nope, return a (now) null element</span>
<a name="l00531"></a>00531 <span class="keywordflow">return</span> <a class="codeRef" href="qdomelement.html">QDomElement</a>();
<a name="l00532"></a>00532 }
<a name="l00533"></a>00533
<a name="l00534"></a><a class="code" href="classKXMLGUIClient.html#aa9390c62e041b322cb0f25d07a17e50f">00534</a> <span class="keywordtype">void</span> <a class="code" href="classKXMLGUIClient.html#aa9390c62e041b322cb0f25d07a17e50f" title="This function will attempt to give up some memory after the GUI is built.">KXMLGUIClient::conserveMemory</a>()
<a name="l00535"></a>00535 {
<a name="l00536"></a>00536 d->m_doc = <a class="codeRef" href="qdomdocument.html">QDomDocument</a>();
<a name="l00537"></a>00537 d->m_buildDocument = <a class="codeRef" href="qdomdocument.html">QDomDocument</a>();
<a name="l00538"></a>00538 }
<a name="l00539"></a>00539
<a name="l00540"></a><a class="code" href="classKXMLGUIClient.html#a90f952857036d4be2e42657fe4f981bb">00540</a> <span class="keywordtype">void</span> <a class="code" href="classKXMLGUIClient.html#a90f952857036d4be2e42657fe4f981bb">KXMLGUIClient::setXMLGUIBuildDocument</a>( <span class="keyword">const</span> <a class="codeRef" href="qdomdocument.html">QDomDocument</a> &doc )
<a name="l00541"></a>00541 {
<a name="l00542"></a>00542 d->m_buildDocument = doc;
<a name="l00543"></a>00543 }
<a name="l00544"></a>00544
<a name="l00545"></a><a class="code" href="classKXMLGUIClient.html#a57697fd6558babf0880ed780cc6b9b24">00545</a> <a class="codeRef" href="qdomdocument.html">QDomDocument</a> <a class="code" href="classKXMLGUIClient.html#a57697fd6558babf0880ed780cc6b9b24">KXMLGUIClient::xmlguiBuildDocument</a>()<span class="keyword"> const</span>
<a name="l00546"></a>00546 <span class="keyword"></span>{
<a name="l00547"></a>00547 <span class="keywordflow">return</span> d->m_buildDocument;
<a name="l00548"></a>00548 }
<a name="l00549"></a>00549
<a name="l00550"></a><a class="code" href="classKXMLGUIClient.html#ab1989539c961858a273ca841618e0bf7">00550</a> <span class="keywordtype">void</span> <a class="code" href="classKXMLGUIClient.html#ab1989539c961858a273ca841618e0bf7" title="This method is called by the KXMLGUIFactory as soon as the client is added to the KXMLGUIFactory's GU...">KXMLGUIClient::setFactory</a>( <a class="code" href="classKXMLGUIFactory.html" title="KXMLGUIFactory, together with KXMLGUIClient objects, can be used to create a GUI of container widgets...">KXMLGUIFactory</a> *factory )
<a name="l00551"></a>00551 {
<a name="l00552"></a>00552 d->m_factory = <a class="code" href="classKXMLGUIClient.html#a2c7a5e2f7d02eec609d9f53df364628e" title="Retrieves a pointer to the KXMLGUIFactory this client is associated with (will return 0L if the clien...">factory</a>;
<a name="l00553"></a>00553 }
<a name="l00554"></a>00554
<a name="l00555"></a><a class="code" href="classKXMLGUIClient.html#a2c7a5e2f7d02eec609d9f53df364628e">00555</a> <a class="code" href="classKXMLGUIFactory.html" title="KXMLGUIFactory, together with KXMLGUIClient objects, can be used to create a GUI of container widgets...">KXMLGUIFactory</a> *<a class="code" href="classKXMLGUIClient.html#a2c7a5e2f7d02eec609d9f53df364628e" title="Retrieves a pointer to the KXMLGUIFactory this client is associated with (will return 0L if the clien...">KXMLGUIClient::factory</a>()<span class="keyword"> const</span>
<a name="l00556"></a>00556 <span class="keyword"></span>{
<a name="l00557"></a>00557 <span class="keywordflow">return</span> d->m_factory;
<a name="l00558"></a>00558 }
<a name="l00559"></a>00559
<a name="l00560"></a><a class="code" href="classKXMLGUIClient.html#a6546a34da99de8b53bc75ef510aa566a">00560</a> <a class="code" href="classKXMLGUIClient.html" title="A KXMLGUIClient can be used with KXMLGUIFactory to create a GUI from actions and an XML document...">KXMLGUIClient</a> *<a class="code" href="classKXMLGUIClient.html#a6546a34da99de8b53bc75ef510aa566a" title="KXMLGUIClients can form a simple child/parent object tree.">KXMLGUIClient::parentClient</a>()<span class="keyword"> const</span>
<a name="l00561"></a>00561 <span class="keyword"></span>{
<a name="l00562"></a>00562 <span class="keywordflow">return</span> d->m_parent;
<a name="l00563"></a>00563 }
<a name="l00564"></a>00564
<a name="l00565"></a><a class="code" href="classKXMLGUIClient.html#ad5dead4d8da7a6aa7d6bdf258aa43168">00565</a> <span class="keywordtype">void</span> <a class="code" href="classKXMLGUIClient.html#ad5dead4d8da7a6aa7d6bdf258aa43168" title="Use this method to make a client a child client of another client.">KXMLGUIClient::insertChildClient</a>( <a class="code" href="classKXMLGUIClient.html" title="A KXMLGUIClient can be used with KXMLGUIFactory to create a GUI from actions and an XML document...">KXMLGUIClient</a> *child )
<a name="l00566"></a>00566 {
<a name="l00567"></a>00567 <span class="keywordflow">if</span> ( child->d->m_parent )
<a name="l00568"></a>00568 child->d->m_parent->removeChildClient( child );
<a name="l00569"></a>00569 d->m_children.append( child );
<a name="l00570"></a>00570 child->d->m_parent = <span class="keyword">this</span>;
<a name="l00571"></a>00571 }
<a name="l00572"></a>00572
<a name="l00573"></a><a class="code" href="classKXMLGUIClient.html#a37e2620214e77a8c4edc7597710b7b32">00573</a> <span class="keywordtype">void</span> <a class="code" href="classKXMLGUIClient.html#a37e2620214e77a8c4edc7597710b7b32" title="Removes the given child from the client's children list.">KXMLGUIClient::removeChildClient</a>( <a class="code" href="classKXMLGUIClient.html" title="A KXMLGUIClient can be used with KXMLGUIFactory to create a GUI from actions and an XML document...">KXMLGUIClient</a> *child )
<a name="l00574"></a>00574 {
<a name="l00575"></a>00575 assert( d->m_children.containsRef( child ) );
<a name="l00576"></a>00576 d->m_children.removeRef( child );
<a name="l00577"></a>00577 child->d->m_parent = 0;
<a name="l00578"></a>00578 }
<a name="l00579"></a>00579
<a name="l00580"></a>00580 <span class="comment">/*bool KXMLGUIClient::addSuperClient( KXMLGUIClient *super )</span>
<a name="l00581"></a>00581 <span class="comment">{</span>
<a name="l00582"></a>00582 <span class="comment"> if ( d->m_supers.contains( super ) )</span>
<a name="l00583"></a>00583 <span class="comment"> return false;</span>
<a name="l00584"></a>00584 <span class="comment"> d->m_supers.append( super );</span>
<a name="l00585"></a>00585 <span class="comment"> return true;</span>
<a name="l00586"></a>00586 <span class="comment">}*/</span>
<a name="l00587"></a>00587
<a name="l00588"></a><a class="code" href="classKXMLGUIClient.html#abe5ce2629e9a04f5db5e6546814ca114">00588</a> <span class="keyword">const</span> <a class="codeRef" href="qptrlist.html">QPtrList<KXMLGUIClient></a> *<a class="code" href="classKXMLGUIClient.html#abe5ce2629e9a04f5db5e6546814ca114" title="Retrieves a list of all child clients.">KXMLGUIClient::childClients</a>()
<a name="l00589"></a>00589 {
<a name="l00590"></a>00590 <span class="keywordflow">return</span> &d->m_children;
<a name="l00591"></a>00591 }
<a name="l00592"></a>00592
<a name="l00593"></a><a class="code" href="classKXMLGUIClient.html#a95a2422a35274351314ac5eb4fc9a23e">00593</a> <span class="keywordtype">void</span> <a class="code" href="classKXMLGUIClient.html#a95a2422a35274351314ac5eb4fc9a23e" title="A client can have an own KXMLGUIBuilder.">KXMLGUIClient::setClientBuilder</a>( <a class="code" href="classKXMLGUIBuilder.html" title="Abstract interface for a "GUI builder", used by the GUIFactory This interface is implemented by KMain...">KXMLGUIBuilder</a> *builder )
<a name="l00594"></a>00594 {
<a name="l00595"></a>00595 d->m_builder = builder;
<a name="l00596"></a>00596 <span class="keywordflow">if</span> ( builder )
<a name="l00597"></a>00597 builder->setBuilderInstance( <a class="code" href="classKXMLGUIClient.html#a4fd5c48394a44cfe1ca4091bb2bb7523">instance</a>() );
<a name="l00598"></a>00598 }
<a name="l00599"></a>00599
<a name="l00600"></a><a class="code" href="classKXMLGUIClient.html#a044e446507e958711bffe22eaf9b3334">00600</a> <a class="code" href="classKXMLGUIBuilder.html" title="Abstract interface for a "GUI builder", used by the GUIFactory This interface is implemented by KMain...">KXMLGUIBuilder</a> *<a class="code" href="classKXMLGUIClient.html#a044e446507e958711bffe22eaf9b3334" title="Retrieves the client's GUI builder or 0L if no client specific builder has been assigned via setClien...">KXMLGUIClient::clientBuilder</a>()<span class="keyword"> const</span>
<a name="l00601"></a>00601 <span class="keyword"></span>{
<a name="l00602"></a>00602 <span class="keywordflow">return</span> d->m_builder;
<a name="l00603"></a>00603 }
<a name="l00604"></a>00604
<a name="l00605"></a><a class="code" href="classKXMLGUIClient.html#a780646f18f57f2c2776672256f8fdc98">00605</a> <span class="keywordtype">void</span> <a class="code" href="classKXMLGUIClient.html#a780646f18f57f2c2776672256f8fdc98" title="ActionLists are a way for XMLGUI to support dynamic lists of actions.">KXMLGUIClient::plugActionList</a>( <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a> &name, <span class="keyword">const</span> <a class="codeRef" href="qptrlist.html">QPtrList<KAction></a> &actionList )
<a name="l00606"></a>00606 {
<a name="l00607"></a>00607 <span class="keywordflow">if</span> ( !d->m_factory )
<a name="l00608"></a>00608 <span class="keywordflow">return</span>;
<a name="l00609"></a>00609
<a name="l00610"></a>00610 d->m_factory->plugActionList( <span class="keyword">this</span>, name, actionList );
<a name="l00611"></a>00611 }
<a name="l00612"></a>00612
<a name="l00613"></a><a class="code" href="classKXMLGUIClient.html#a65b212e793ec67d341d7f1ac9355b7fd">00613</a> <span class="keywordtype">void</span> <a class="code" href="classKXMLGUIClient.html#a65b212e793ec67d341d7f1ac9355b7fd" title="The complement of plugActionList() ...">KXMLGUIClient::unplugActionList</a>( <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a> &name )
<a name="l00614"></a>00614 {
<a name="l00615"></a>00615 <span class="keywordflow">if</span> ( !d->m_factory )
<a name="l00616"></a>00616 <span class="keywordflow">return</span>;
<a name="l00617"></a>00617
<a name="l00618"></a>00618 d->m_factory->unplugActionList( <span class="keyword">this</span>, name );
<a name="l00619"></a>00619 }
<a name="l00620"></a>00620
<a name="l00621"></a>00621 <a class="codeRef" href="qstring.html">QString</a> KXMLGUIClient::findMostRecentXMLFile( <span class="keyword">const</span> <a class="codeRef" href="qstringlist.html">QStringList</a> &files, <a class="codeRef" href="qstring.html">QString</a> &doc )
<a name="l00622"></a>00622 {
<a name="l00623"></a>00623
<a name="l00624"></a>00624 <a class="codeRef" href="qvaluelist.html">QValueList<DocStruct></a> allDocuments;
<a name="l00625"></a>00625
<a name="l00626"></a>00626 QStringList::ConstIterator it = files.begin();
<a name="l00627"></a>00627 QStringList::ConstIterator end = files.end();
<a name="l00628"></a>00628 <span class="keywordflow">for</span> (; it != end; ++it )
<a name="l00629"></a>00629 {
<a name="l00630"></a>00630 <span class="comment">//kdDebug() << "KXMLGUIClient::findMostRecentXMLFile " << *it << endl;</span>
<a name="l00631"></a>00631 <a class="codeRef" href="qstring.html">QString</a> data = KXMLGUIFactory::readConfigFile( *it );
<a name="l00632"></a>00632 DocStruct d;
<a name="l00633"></a>00633 d.file = *it;
<a name="l00634"></a>00634 d.data = data;
<a name="l00635"></a>00635 allDocuments.<a class="codeRef" href="qvaluelist.html#append">append</a>( d );
<a name="l00636"></a>00636 }
<a name="l00637"></a>00637
<a name="l00638"></a>00638 <a class="codeRef" href="qvaluelist.html">QValueList<DocStruct>::Iterator</a> best = allDocuments.<a class="codeRef" href="qvaluelist.html#end">end</a>();
<a name="l00639"></a>00639 uint bestVersion = 0;
<a name="l00640"></a>00640
<a name="l00641"></a>00641 <a class="codeRef" href="qvaluelist.html">QValueList<DocStruct>::Iterator</a> docIt = allDocuments.<a class="codeRef" href="qvaluelist.html#begin">begin</a>();
<a name="l00642"></a>00642 <a class="codeRef" href="qvaluelist.html">QValueList<DocStruct>::Iterator</a> docEnd = allDocuments.<a class="codeRef" href="qvaluelist.html#end">end</a>();
<a name="l00643"></a>00643 <span class="keywordflow">for</span> (; docIt != docEnd; ++docIt )
<a name="l00644"></a>00644 {
<a name="l00645"></a>00645 <a class="codeRef" href="qstring.html">QString</a> versionStr = findVersionNumber( (*docIt).data );
<a name="l00646"></a>00646 <span class="keywordflow">if</span> ( versionStr.<a class="codeRef" href="qstring.html#isEmpty">isEmpty</a>() )
<a name="l00647"></a>00647 <span class="keywordflow">continue</span>;
<a name="l00648"></a>00648
<a name="l00649"></a>00649 <span class="keywordtype">bool</span> ok = <span class="keyword">false</span>;
<a name="l00650"></a>00650 uint <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/namespaceKDE.html#aa7220767389d3c119ac8cf38bf333c55">version</a> = versionStr.<a class="codeRef" href="qstring.html#toUInt">toUInt</a>( &ok );
<a name="l00651"></a>00651 <span class="keywordflow">if</span> ( !ok )
<a name="l00652"></a>00652 <span class="keywordflow">continue</span>;
<a name="l00653"></a>00653 <span class="comment">//kdDebug() << "FOUND VERSION " << version << endl;</span>
<a name="l00654"></a>00654
<a name="l00655"></a>00655 <span class="keywordflow">if</span> ( version > bestVersion )
<a name="l00656"></a>00656 {
<a name="l00657"></a>00657 best = docIt;
<a name="l00658"></a>00658 <span class="comment">//kdDebug() << "best version is now " << version << endl;</span>
<a name="l00659"></a>00659 bestVersion = version;
<a name="l00660"></a>00660 }
<a name="l00661"></a>00661 }
<a name="l00662"></a>00662
<a name="l00663"></a>00663 <span class="keywordflow">if</span> ( best != docEnd )
<a name="l00664"></a>00664 {
<a name="l00665"></a>00665 <span class="keywordflow">if</span> ( best != allDocuments.<a class="codeRef" href="qvaluelist.html#begin">begin</a>() )
<a name="l00666"></a>00666 {
<a name="l00667"></a>00667 <a class="codeRef" href="qvaluelist.html">QValueList<DocStruct>::Iterator</a> local = allDocuments.<a class="codeRef" href="qvaluelist.html#begin">begin</a>();
<a name="l00668"></a>00668
<a name="l00669"></a>00669 <span class="comment">// load the local document and extract the action properties</span>
<a name="l00670"></a>00670 <a class="codeRef" href="qdomdocument.html">QDomDocument</a> document;
<a name="l00671"></a>00671 document.<a class="codeRef" href="qdomdocument.html#setContent">setContent</a>( (*local).data );
<a name="l00672"></a>00672
<a name="l00673"></a>00673 ActionPropertiesMap properties = extractActionProperties( document );
<a name="l00674"></a>00674
<a name="l00675"></a>00675 <span class="comment">// in case the document has a ActionProperties section</span>
<a name="l00676"></a>00676 <span class="comment">// we must not delete it but copy over the global doc</span>
<a name="l00677"></a>00677 <span class="comment">// to the local and insert the ActionProperties section</span>
<a name="l00678"></a>00678 <span class="keywordflow">if</span> ( !properties.isEmpty() )
<a name="l00679"></a>00679 {
<a name="l00680"></a>00680 <span class="comment">// now load the global one with the higher version number</span>
<a name="l00681"></a>00681 <span class="comment">// into memory</span>
<a name="l00682"></a>00682 document.<a class="codeRef" href="qdomdocument.html#setContent">setContent</a>( (*best).data );
<a name="l00683"></a>00683 <span class="comment">// and store the properties in there</span>
<a name="l00684"></a>00684 storeActionProperties( document, properties );
<a name="l00685"></a>00685
<a name="l00686"></a>00686 (*local).data = document.<a class="codeRef" href="qdomdocument.html#toString">toString</a>();
<a name="l00687"></a>00687 <span class="comment">// make sure we pick up the new local doc, when we return later</span>
<a name="l00688"></a>00688 best = local;
<a name="l00689"></a>00689
<a name="l00690"></a>00690 <span class="comment">// write out the new version of the local document</span>
<a name="l00691"></a>00691 <a class="codeRef" href="qfile.html">QFile</a> f( (*local).file );
<a name="l00692"></a>00692 <span class="keywordflow">if</span> ( f.open( IO_WriteOnly ) )
<a name="l00693"></a>00693 {
<a name="l00694"></a>00694 <a class="codeRef" href="qcstring.html">QCString</a> utf8data = (*local).data.utf8();
<a name="l00695"></a>00695 f.writeBlock( utf8data.data(), utf8data.<a class="codeRef" href="qcstring.html#length">length</a>() );
<a name="l00696"></a>00696 f.close();
<a name="l00697"></a>00697 }
<a name="l00698"></a>00698 }
<a name="l00699"></a>00699 <span class="keywordflow">else</span>
<a name="l00700"></a>00700 {
<a name="l00701"></a>00701 <a class="codeRef" href="qstring.html">QString</a> f = (*local).file;
<a name="l00702"></a>00702 <a class="codeRef" href="qstring.html">QString</a> backup = f + <a class="codeRef" href="qstring.html#fromLatin1">QString::fromLatin1</a>( <span class="stringliteral">".backup"</span> );
<a name="l00703"></a>00703 <a class="codeRef" href="qdir.html">QDir</a> dir;
<a name="l00704"></a>00704 dir.<a class="codeRef" href="qdir.html#rename">rename</a>( f, backup );
<a name="l00705"></a>00705 }
<a name="l00706"></a>00706 }
<a name="l00707"></a>00707 doc = (*best).<a class="codeRef" href="qstring.html#data">data</a>;
<a name="l00708"></a>00708 <span class="keywordflow">return</span> (*best).file;
<a name="l00709"></a>00709 }
<a name="l00710"></a>00710 <span class="keywordflow">else</span> <span class="keywordflow">if</span> ( files.count() > 0 )
<a name="l00711"></a>00711 {
<a name="l00712"></a>00712 <span class="comment">//kdDebug() << "returning first one..." << endl;</span>
<a name="l00713"></a>00713 doc = (*allDocuments.<a class="codeRef" href="qvaluelist.html#begin">begin</a>()).data;
<a name="l00714"></a>00714 <span class="keywordflow">return</span> (*allDocuments.<a class="codeRef" href="qvaluelist.html#begin">begin</a>()).file;
<a name="l00715"></a>00715 }
<a name="l00716"></a>00716
<a name="l00717"></a>00717 <span class="keywordflow">return</span> QString::null;
<a name="l00718"></a>00718 }
<a name="l00719"></a>00719
<a name="l00720"></a>00720
<a name="l00721"></a>00721
<a name="l00722"></a>00722 <a class="codeRef" href="qstring.html">QString</a> KXMLGUIClient::findVersionNumber( <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a> &xml )
<a name="l00723"></a>00723 {
<a name="l00724"></a>00724 <span class="keyword">enum</span> { ST_START, ST_AFTER_OPEN, ST_AFTER_GUI,
<a name="l00725"></a>00725 ST_EXPECT_VERSION, ST_VERSION_NUM} state = ST_START;
<a name="l00726"></a>00726 <span class="keywordflow">for</span> (<span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> pos = 0; pos < xml.<a class="codeRef" href="qstring.html#length">length</a>(); pos++)
<a name="l00727"></a>00727 {
<a name="l00728"></a>00728 <span class="keywordflow">switch</span> (state)
<a name="l00729"></a>00729 {
<a name="l00730"></a>00730 <span class="keywordflow">case</span> ST_START:
<a name="l00731"></a>00731 <span class="keywordflow">if</span> (xml[pos] == <span class="charliteral">'<'</span>)
<a name="l00732"></a>00732 state = ST_AFTER_OPEN;
<a name="l00733"></a>00733 <span class="keywordflow">break</span>;
<a name="l00734"></a>00734 <span class="keywordflow">case</span> ST_AFTER_OPEN:
<a name="l00735"></a>00735 {
<a name="l00736"></a>00736 <span class="comment">//Jump to gui..</span>
<a name="l00737"></a>00737 <span class="keywordtype">int</span> guipos = xml.<a class="codeRef" href="qstring.html#find">find</a>(<span class="stringliteral">"gui"</span>, pos, <span class="keyword">false</span> <span class="comment">/*case-insensitive*/</span>);
<a name="l00738"></a>00738 <span class="keywordflow">if</span> (guipos == -1)
<a name="l00739"></a>00739 <span class="keywordflow">return</span> QString::null; <span class="comment">//Reject</span>
<a name="l00740"></a>00740
<a name="l00741"></a>00741 pos = guipos + 2; <span class="comment">//Position at i, so we're moved ahead to the next character by the ++;</span>
<a name="l00742"></a>00742 state = ST_AFTER_GUI;
<a name="l00743"></a>00743 <span class="keywordflow">break</span>;
<a name="l00744"></a>00744 }
<a name="l00745"></a>00745 <span class="keywordflow">case</span> ST_AFTER_GUI:
<a name="l00746"></a>00746 state = ST_EXPECT_VERSION;
<a name="l00747"></a>00747 <span class="keywordflow">break</span>;
<a name="l00748"></a>00748 <span class="keywordflow">case</span> ST_EXPECT_VERSION:
<a name="l00749"></a>00749 {
<a name="l00750"></a>00750 <span class="keywordtype">int</span> verpos = xml.<a class="codeRef" href="qstring.html#find">find</a>(<span class="stringliteral">"version=\""</span>, pos, <span class="keyword">false</span> <span class="comment">/*case-insensitive*/</span>);
<a name="l00751"></a>00751 <span class="keywordflow">if</span> (verpos == -1)
<a name="l00752"></a>00752 <span class="keywordflow">return</span> QString::null; <span class="comment">//Reject</span>
<a name="l00753"></a>00753
<a name="l00754"></a>00754 pos = verpos + 8; <span class="comment">//v = 0, e = +1, r = +2, s = +3 , i = +4, o = +5, n = +6, = = +7, " = + 8</span>
<a name="l00755"></a>00755 state = ST_VERSION_NUM;
<a name="l00756"></a>00756 <span class="keywordflow">break</span>;
<a name="l00757"></a>00757 }
<a name="l00758"></a>00758 <span class="keywordflow">case</span> ST_VERSION_NUM:
<a name="l00759"></a>00759 {
<a name="l00760"></a>00760 <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> endpos;
<a name="l00761"></a>00761 <span class="keywordflow">for</span> (endpos = pos; endpos < xml.<a class="codeRef" href="qstring.html#length">length</a>(); endpos++)
<a name="l00762"></a>00762 {
<a name="l00763"></a>00763 <span class="keywordflow">if</span> (xml[endpos].unicode() >= <span class="charliteral">'0'</span> && xml[endpos].<a class="codeRef" href="qstring.html#unicode">unicode</a>() <= <span class="charliteral">'9'</span>)
<a name="l00764"></a>00764 <span class="keywordflow">continue</span>; <span class="comment">//Number..</span>
<a name="l00765"></a>00765 <span class="keywordflow">if</span> (xml[endpos].unicode() == <span class="charliteral">'"'</span>) <span class="comment">//End of parameter</span>
<a name="l00766"></a>00766 <span class="keywordflow">break</span>;
<a name="l00767"></a>00767 <span class="keywordflow">else</span> <span class="comment">//This shouldn't be here..</span>
<a name="l00768"></a>00768 {
<a name="l00769"></a>00769 endpos = xml.<a class="codeRef" href="qstring.html#length">length</a>();
<a name="l00770"></a>00770 }
<a name="l00771"></a>00771 }
<a name="l00772"></a>00772
<a name="l00773"></a>00773 <span class="keywordflow">if</span> (endpos != pos && endpos < xml.<a class="codeRef" href="qstring.html#length">length</a>() )
<a name="l00774"></a>00774 {
<a name="l00775"></a>00775 <a class="codeRef" href="qstring.html">QString</a> matchCandidate = xml.<a class="codeRef" href="qstring.html#mid">mid</a>(pos, endpos - pos); <span class="comment">//Don't include " ".</span>
<a name="l00776"></a>00776 <span class="keywordflow">return</span> matchCandidate;
<a name="l00777"></a>00777 }
<a name="l00778"></a>00778
<a name="l00779"></a>00779 state = ST_EXPECT_VERSION; <span class="comment">//Try to match a well-formed version..</span>
<a name="l00780"></a>00780 <span class="keywordflow">break</span>;
<a name="l00781"></a>00781 } <span class="comment">//case..</span>
<a name="l00782"></a>00782 } <span class="comment">//switch</span>
<a name="l00783"></a>00783 } <span class="comment">//for</span>
<a name="l00784"></a>00784
<a name="l00785"></a>00785 <span class="keywordflow">return</span> QString::null;
<a name="l00786"></a>00786 }
<a name="l00787"></a>00787
<a name="l00788"></a>00788 <a class="codeRef" href="qmap.html">KXMLGUIClient::ActionPropertiesMap</a> KXMLGUIClient::extractActionProperties( <span class="keyword">const</span> <a class="codeRef" href="qdomdocument.html">QDomDocument</a> &doc )
<a name="l00789"></a>00789 {
<a name="l00790"></a>00790 ActionPropertiesMap properties;
<a name="l00791"></a>00791
<a name="l00792"></a>00792 <a class="codeRef" href="qdomelement.html">QDomElement</a> actionPropElement = doc.<a class="codeRef" href="qdomdocument.html#documentElement">documentElement</a>().namedItem( <span class="stringliteral">"ActionProperties"</span> ).toElement();
<a name="l00793"></a>00793
<a name="l00794"></a>00794 <span class="keywordflow">if</span> ( actionPropElement.isNull() )
<a name="l00795"></a>00795 <span class="keywordflow">return</span> properties;
<a name="l00796"></a>00796
<a name="l00797"></a>00797 <a class="codeRef" href="qdomnode.html">QDomNode</a> n = actionPropElement.firstChild();
<a name="l00798"></a>00798 <span class="keywordflow">while</span>(!n.<a class="codeRef" href="qdomnode.html#isNull">isNull</a>())
<a name="l00799"></a>00799 {
<a name="l00800"></a>00800 <a class="codeRef" href="qdomelement.html">QDomElement</a> e = n.<a class="codeRef" href="qdomnode.html#toElement">toElement</a>();
<a name="l00801"></a>00801 n = n.<a class="codeRef" href="qdomnode.html#nextSibling">nextSibling</a>(); <span class="comment">// Advance now so that we can safely delete e</span>
<a name="l00802"></a>00802 <span class="keywordflow">if</span> ( e.isNull() )
<a name="l00803"></a>00803 <span class="keywordflow">continue</span>;
<a name="l00804"></a>00804
<a name="l00805"></a>00805 <span class="keywordflow">if</span> ( e.<a class="codeRef" href="qdomelement.html#tagName">tagName</a>().lower() != <span class="stringliteral">"action"</span> )
<a name="l00806"></a>00806 <span class="keywordflow">continue</span>;
<a name="l00807"></a>00807
<a name="l00808"></a>00808 <a class="codeRef" href="qstring.html">QString</a> actionName = e.<a class="codeRef" href="qdomelement.html#attribute">attribute</a>( <span class="stringliteral">"name"</span> );
<a name="l00809"></a>00809
<a name="l00810"></a>00810 <span class="keywordflow">if</span> ( actionName.<a class="codeRef" href="qstring.html#isEmpty">isEmpty</a>() )
<a name="l00811"></a>00811 <span class="keywordflow">continue</span>;
<a name="l00812"></a>00812
<a name="l00813"></a>00813 <a class="codeRef" href="qmap.html">QMap<QString, QMap<QString, QString></a> >::Iterator propIt = properties.<a class="codeRef" href="qmap.html#find">find</a>( actionName );
<a name="l00814"></a>00814 <span class="keywordflow">if</span> ( propIt == properties.<a class="codeRef" href="qmap.html#end">end</a>() )
<a name="l00815"></a>00815 propIt = properties.<a class="codeRef" href="qmap.html#insert">insert</a>( actionName, <a class="codeRef" href="qmap.html">QMap<QString, QString></a>() );
<a name="l00816"></a>00816
<a name="l00817"></a>00817 <span class="keyword">const</span> <a class="codeRef" href="qdomnamednodemap.html">QDomNamedNodeMap</a> attributes = e.<a class="codeRef" href="qdomelement.html#attributes">attributes</a>();
<a name="l00818"></a>00818 <span class="keyword">const</span> uint attributeslength = attributes.<a class="codeRef" href="qdomnamednodemap.html#length">length</a>();
<a name="l00819"></a>00819
<a name="l00820"></a>00820 <span class="keywordflow">for</span> ( uint i = 0; i < attributeslength; ++i )
<a name="l00821"></a>00821 {
<a name="l00822"></a>00822 <span class="keyword">const</span> <a class="codeRef" href="qdomattr.html">QDomAttr</a> attr = attributes.<a class="codeRef" href="qdomnamednodemap.html#item">item</a>( i ).toAttr();
<a name="l00823"></a>00823
<a name="l00824"></a>00824 <span class="keywordflow">if</span> ( attr.isNull() )
<a name="l00825"></a>00825 <span class="keywordflow">continue</span>;
<a name="l00826"></a>00826
<a name="l00827"></a>00827 <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a> name = attr.<a class="codeRef" href="qdomattr.html#name">name</a>();
<a name="l00828"></a>00828
<a name="l00829"></a>00829 <span class="keywordflow">if</span> ( name == <span class="stringliteral">"name"</span> || name.<a class="codeRef" href="qstring.html#isEmpty">isEmpty</a>() )
<a name="l00830"></a>00830 <span class="keywordflow">continue</span>;
<a name="l00831"></a>00831
<a name="l00832"></a>00832 (*propIt)[ name ] = attr.<a class="codeRef" href="qdomattr.html#value">value</a>();
<a name="l00833"></a>00833 }
<a name="l00834"></a>00834
<a name="l00835"></a>00835 }
<a name="l00836"></a>00836
<a name="l00837"></a>00837 <span class="keywordflow">return</span> properties;
<a name="l00838"></a>00838 }
<a name="l00839"></a>00839
<a name="l00840"></a>00840 <span class="keywordtype">void</span> KXMLGUIClient::storeActionProperties( <a class="codeRef" href="qdomdocument.html">QDomDocument</a> &doc, <span class="keyword">const</span> ActionPropertiesMap &properties )
<a name="l00841"></a>00841 {
<a name="l00842"></a>00842 <a class="codeRef" href="qdomelement.html">QDomElement</a> actionPropElement = doc.<a class="codeRef" href="qdomdocument.html#documentElement">documentElement</a>().namedItem( <span class="stringliteral">"ActionProperties"</span> ).toElement();
<a name="l00843"></a>00843
<a name="l00844"></a>00844 <span class="keywordflow">if</span> ( actionPropElement.isNull() )
<a name="l00845"></a>00845 {
<a name="l00846"></a>00846 actionPropElement = doc.<a class="codeRef" href="qdomdocument.html#createElement">createElement</a>( <span class="stringliteral">"ActionProperties"</span> );
<a name="l00847"></a>00847 doc.<a class="codeRef" href="qdomdocument.html#documentElement">documentElement</a>().appendChild( actionPropElement );
<a name="l00848"></a>00848 }
<a name="l00849"></a>00849
<a name="l00850"></a>00850 <span class="keywordflow">while</span> ( !actionPropElement.firstChild().isNull() )
<a name="l00851"></a>00851 actionPropElement.removeChild( actionPropElement.firstChild() );
<a name="l00852"></a>00852
<a name="l00853"></a>00853 <a class="codeRef" href="qmap.html#ConstIterator">ActionPropertiesMap::ConstIterator</a> it = properties.begin();
<a name="l00854"></a>00854 <a class="codeRef" href="qmap.html#ConstIterator">ActionPropertiesMap::ConstIterator</a> end = properties.end();
<a name="l00855"></a>00855 <span class="keywordflow">for</span> (; it != end; ++it )
<a name="l00856"></a>00856 {
<a name="l00857"></a>00857 <a class="codeRef" href="qdomelement.html">QDomElement</a> <a class="code" href="classKXMLGUIClient.html#a1ad7e513dcb1d0526fda4279f60b9fd3" title="Retrieves an action of the client by name.">action</a> = doc.<a class="codeRef" href="qdomdocument.html#createElement">createElement</a>( <span class="stringliteral">"Action"</span> );
<a name="l00858"></a>00858 action.<a class="codeRef" href="qdomelement.html#setAttribute">setAttribute</a>( <span class="stringliteral">"name"</span>, it.key() );
<a name="l00859"></a>00859 actionPropElement.appendChild( action );
<a name="l00860"></a>00860
<a name="l00861"></a>00861 <a class="codeRef" href="qmap.html">QMap<QString, QString></a> attributes = (*it);
<a name="l00862"></a>00862 <a class="codeRef" href="qmap.html">QMap<QString, QString>::ConstIterator</a> attrIt = attributes.<a class="codeRef" href="qmap.html#begin">begin</a>();
<a name="l00863"></a>00863 <a class="codeRef" href="qmap.html">QMap<QString, QString>::ConstIterator</a> attrEnd = attributes.<a class="codeRef" href="qmap.html#end">end</a>();
<a name="l00864"></a>00864 <span class="keywordflow">for</span> (; attrIt != attrEnd; ++attrIt )
<a name="l00865"></a>00865 action.<a class="codeRef" href="qdomelement.html#setAttribute">setAttribute</a>( attrIt.key(), attrIt.data() );
<a name="l00866"></a>00866 }
<a name="l00867"></a>00867 }
<a name="l00868"></a>00868
<a name="l00869"></a>00869 <span class="keywordtype">void</span> KXMLGUIClient::addStateActionEnabled(<span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>& state,
<a name="l00870"></a>00870 <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>& action)
<a name="l00871"></a>00871 {
<a name="l00872"></a>00872 StateChange stateChange = getActionsToChangeForState(state);
<a name="l00873"></a>00873
<a name="l00874"></a>00874 stateChange.actionsToEnable.append( action );
<a name="l00875"></a>00875 <span class="comment">//kdDebug() << "KXMLGUIClient::addStateActionEnabled( " << state << ", " << action << ")" << endl;</span>
<a name="l00876"></a>00876
<a name="l00877"></a>00877 m_actionsStateMap.<a class="codeRef" href="qmap.html#replace">replace</a>( state, stateChange );
<a name="l00878"></a>00878 }
<a name="l00879"></a>00879
<a name="l00880"></a>00880
<a name="l00881"></a>00881 <span class="keywordtype">void</span> KXMLGUIClient::addStateActionDisabled(<span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>& state,
<a name="l00882"></a>00882 <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>& action)
<a name="l00883"></a>00883 {
<a name="l00884"></a>00884 StateChange stateChange = getActionsToChangeForState(state);
<a name="l00885"></a>00885
<a name="l00886"></a>00886 stateChange.actionsToDisable.append( action );
<a name="l00887"></a>00887 <span class="comment">//kdDebug() << "KXMLGUIClient::addStateActionDisabled( " << state << ", " << action << ")" << endl;</span>
<a name="l00888"></a>00888
<a name="l00889"></a>00889 m_actionsStateMap.<a class="codeRef" href="qmap.html#replace">replace</a>( state, stateChange );
<a name="l00890"></a>00890 }
<a name="l00891"></a>00891
<a name="l00892"></a>00892
<a name="l00893"></a>00893 KXMLGUIClient::StateChange KXMLGUIClient::getActionsToChangeForState(<span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>& state)
<a name="l00894"></a>00894 {
<a name="l00895"></a>00895 <span class="keywordflow">return</span> m_actionsStateMap[state];
<a name="l00896"></a>00896 }
<a name="l00897"></a>00897
<a name="l00898"></a>00898
<a name="l00899"></a><a class="code" href="classKXMLGUIClient.html#a4a5c7bb39d27c6082ea989e19b3e3bcf">00899</a> <span class="keywordtype">void</span> <a class="code" href="classKXMLGUIClient.html#a4a5c7bb39d27c6082ea989e19b3e3bcf" title="Actions can collectively be assigned a "State".">KXMLGUIClient::stateChanged</a>(<span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a> &newstate, KXMLGUIClient::ReverseStateChange reverse)
<a name="l00900"></a>00900 {
<a name="l00901"></a>00901 StateChange stateChange = getActionsToChangeForState(newstate);
<a name="l00902"></a>00902
<a name="l00903"></a>00903 <span class="keywordtype">bool</span> setTrue = (reverse == StateNoReverse);
<a name="l00904"></a>00904 <span class="keywordtype">bool</span> setFalse = !setTrue;
<a name="l00905"></a>00905
<a name="l00906"></a>00906 <span class="comment">// Enable actions which need to be enabled...</span>
<a name="l00907"></a>00907 <span class="comment">//</span>
<a name="l00908"></a>00908 <span class="keywordflow">for</span> ( QStringList::Iterator it = stateChange.actionsToEnable.begin();
<a name="l00909"></a>00909 it != stateChange.actionsToEnable.end(); ++it ) {
<a name="l00910"></a>00910
<a name="l00911"></a>00911 <a class="code" href="classKAction.html" title="Class to encapsulate user-driven action or event.">KAction</a> *action = <a class="code" href="classKXMLGUIClient.html#a7f996e74cc024ccceb6d96fba355b9a0" title="Retrieves the entire action collection for the GUI client.">actionCollection</a>()-><a class="code" href="classKActionCollection.html#a78b5a9b8e1bd82d6a59fe67501a0fdc8" title="Return the KAction* at position "index" in the action collection.">action</a>((*it).latin1());
<a name="l00912"></a>00912 <span class="keywordflow">if</span> (action) action-><a class="code" href="classKAction.html#a8a4bba333f349bed600f4d3fd9104510" title="Enables or disables this action.">setEnabled</a>(setTrue);
<a name="l00913"></a>00913 }
<a name="l00914"></a>00914
<a name="l00915"></a>00915 <span class="comment">// and disable actions which need to be disabled...</span>
<a name="l00916"></a>00916 <span class="comment">//</span>
<a name="l00917"></a>00917 <span class="keywordflow">for</span> ( QStringList::Iterator it = stateChange.actionsToDisable.begin();
<a name="l00918"></a>00918 it != stateChange.actionsToDisable.end(); ++it ) {
<a name="l00919"></a>00919
<a name="l00920"></a>00920 <a class="code" href="classKAction.html" title="Class to encapsulate user-driven action or event.">KAction</a> *action = <a class="code" href="classKXMLGUIClient.html#a7f996e74cc024ccceb6d96fba355b9a0" title="Retrieves the entire action collection for the GUI client.">actionCollection</a>()-><a class="code" href="classKActionCollection.html#a78b5a9b8e1bd82d6a59fe67501a0fdc8" title="Return the KAction* at position "index" in the action collection.">action</a>((*it).latin1());
<a name="l00921"></a>00921 <span class="keywordflow">if</span> (action) action-><a class="code" href="classKAction.html#a8a4bba333f349bed600f4d3fd9104510" title="Enables or disables this action.">setEnabled</a>(setFalse);
<a name="l00922"></a>00922 }
<a name="l00923"></a>00923
<a name="l00924"></a>00924 }
<a name="l00925"></a>00925
<a name="l00926"></a><a class="code" href="classKXMLGUIClient.html#ab04d7eea7d54ea1b6828df3c5380090c">00926</a> <span class="keywordtype">void</span> <a class="code" href="classKXMLGUIClient.html#ab04d7eea7d54ea1b6828df3c5380090c">KXMLGUIClient::beginXMLPlug</a>( <a class="codeRef" href="qwidget.html">QWidget</a> *w )
<a name="l00927"></a>00927 {
<a name="l00928"></a>00928 <a class="code" href="classKXMLGUIClient.html#a7f996e74cc024ccceb6d96fba355b9a0" title="Retrieves the entire action collection for the GUI client.">actionCollection</a>()->beginXMLPlug( w );
<a name="l00929"></a>00929 <a class="codeRef" href="qptrlistiterator.html">QPtrListIterator<KXMLGUIClient></a> childIt( d->m_children );
<a name="l00930"></a>00930 <span class="keywordflow">for</span> (; childIt.<a class="codeRef" href="qptrlistiterator.html#current">current</a>(); ++childIt )
<a name="l00931"></a>00931 childIt.<a class="codeRef" href="qptrlistiterator.html#current">current</a>()->actionCollection()->beginXMLPlug( w );
<a name="l00932"></a>00932 }
<a name="l00933"></a>00933
<a name="l00934"></a><a class="code" href="classKXMLGUIClient.html#a812c503a45b72a6859c6e9d373aad75f">00934</a> <span class="keywordtype">void</span> <a class="code" href="classKXMLGUIClient.html#a812c503a45b72a6859c6e9d373aad75f">KXMLGUIClient::endXMLPlug</a>()
<a name="l00935"></a>00935 {
<a name="l00936"></a>00936 <a class="code" href="classKXMLGUIClient.html#a7f996e74cc024ccceb6d96fba355b9a0" title="Retrieves the entire action collection for the GUI client.">actionCollection</a>()->endXMLPlug();
<a name="l00937"></a>00937 <a class="codeRef" href="qptrlistiterator.html">QPtrListIterator<KXMLGUIClient></a> childIt( d->m_children );
<a name="l00938"></a>00938 <span class="keywordflow">for</span> (; childIt.<a class="codeRef" href="qptrlistiterator.html#current">current</a>(); ++childIt )
<a name="l00939"></a>00939 childIt.<a class="codeRef" href="qptrlistiterator.html#current">current</a>()->actionCollection()->endXMLPlug();
<a name="l00940"></a>00940 }
<a name="l00941"></a>00941
<a name="l00942"></a><a class="code" href="classKXMLGUIClient.html#a12527a974521110a7c987e393c5bde07">00942</a> <span class="keywordtype">void</span> <a class="code" href="classKXMLGUIClient.html#a12527a974521110a7c987e393c5bde07">KXMLGUIClient::prepareXMLUnplug</a>( <a class="codeRef" href="qwidget.html">QWidget</a> * )
<a name="l00943"></a>00943 {
<a name="l00944"></a>00944 <a class="code" href="classKXMLGUIClient.html#a7f996e74cc024ccceb6d96fba355b9a0" title="Retrieves the entire action collection for the GUI client.">actionCollection</a>()->prepareXMLUnplug();
<a name="l00945"></a>00945 <a class="codeRef" href="qptrlistiterator.html">QPtrListIterator<KXMLGUIClient></a> childIt( d->m_children );
<a name="l00946"></a>00946 <span class="keywordflow">for</span> (; childIt.<a class="codeRef" href="qptrlistiterator.html#current">current</a>(); ++childIt )
<a name="l00947"></a>00947 childIt.<a class="codeRef" href="qptrlistiterator.html#current">current</a>()->actionCollection()->prepareXMLUnplug();
<a name="l00948"></a>00948 }
<a name="l00949"></a>00949
<a name="l00950"></a>00950 <span class="keywordtype">void</span> KXMLGUIClient::virtual_hook( <span class="keywordtype">int</span>, <span class="keywordtype">void</span>* )
<a name="l00951"></a>00951 { <span class="comment">/*BASE::virtual_hook( id, data );*/</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>kdeui</h2>
<div class="nav_list">
<ul><li><a href="index.html">Main Page</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="classKAboutApplication.html">kaboutapplication</option>, <option value="classKAboutContainer.html">kaboutcontainer</option>, <option value="classKAboutContainerBase.html">kaboutcontainerbase</option>, <option value="classKAboutContributor.html">kaboutcontributor</option>, <option value="classKAboutDialog.html">kaboutdialog</option>, <option value="classKAboutKDE.html">kaboutkde</option>, <option value="classKAboutWidget.html">kaboutwidget</option>, <option value="classKAccelGen_1_1Deref.html">kaccelgen::deref</option>, <option value="classKAccelGen_1_1Deref__Key.html">kaccelgen::deref__key</option>, <option value="classKAction.html">kaction</option>, <option value="classKActionCollection.html">kactioncollection</option>, <option value="classKActionMenu.html">kactionmenu</option>, <option value="classKActionSelector.html">kactionselector</option>, <option value="classKActiveLabel.html">kactivelabel</option>, <option value="classKAnimWidget.html">kanimwidget</option>, <option value="classKArrowButton.html">karrowbutton</option>, <option value="classKAuthIcon.html">kauthicon</option>, <option value="classKBugReport.html">kbugreport</option>, <option value="classKButtonBox.html">kbuttonbox</option>, <option value="classKCharSelect.html">kcharselect</option>, <option value="classKCharSelectTable.html">kcharselecttable</option>, <option value="classKCModule.html">kcmodule</option>, <option value="classKColor.html">kcolor</option>, <option value="classKColorButton.html">kcolorbutton</option>, <option value="classKColorCells.html">kcolorcells</option>, <option value="classKColorCombo.html">kcolorcombo</option>, <option value="classKColorDialog.html">kcolordialog</option>, <option value="classKColorDrag.html">kcolordrag</option>, <option value="classKColorPatch.html">kcolorpatch</option>, <option value="classKComboBox.html">kcombobox</option>, <option value="classKCommand.html">kcommand</option>, <option value="classKCommandHistory.html">kcommandhistory</option>, <option value="classKCompletionBox.html">kcompletionbox</option>, <option value="classKConfigDialog.html">kconfigdialog</option>, <option value="classKContextMenuManager.html">kcontextmenumanager</option>, <option value="classKCursor.html">kcursor</option>, <option value="classKCursorPrivate.html">kcursorprivate</option>, <option value="classKCursorPrivateAutoHideEventFilter.html">kcursorprivateautohideeventfilter</option>, <option value="classKDateInternalMonthPicker.html">kdateinternalmonthpicker</option>, <option value="classKDateInternalWeekSelector.html">kdateinternalweekselector</option>, <option value="classKDateInternalYearSelector.html">kdateinternalyearselector</option>, <option value="classKDatePicker.html">kdatepicker</option>, <option value="classKDateTable.html">kdatetable</option>, <option value="classKDateTimeWidget.html">kdatetimewidget</option>, <option value="classKDateValidator.html">kdatevalidator</option>, <option value="classKDateWidget.html">kdatewidget</option>, <option value="classKDCOPActionProxy.html">kdcopactionproxy</option>, <option value="classKDEPrivate_1_1ToolBarHandler.html">kdeprivate::toolbarhandler</option>, <option value="classKDialog.html">kdialog</option>, <option value="classKDialogBase.html">kdialogbase</option>, <option value="classKDialogBaseButton.html">kdialogbasebutton</option>, <option value="classKDialogBaseTile.html">kdialogbasetile</option>, <option value="classKDictSpellingHighlighter.html">kdictspellinghighlighter</option>, <option value="classKDockButton__Private.html">kdockbutton__private</option>, <option value="classKDockMainWindow.html">kdockmainwindow</option>, <option value="classKDockManager.html">kdockmanager</option>, <option value="classKDockSplitter.html">kdocksplitter</option>, <option value="classKDockTabGroup.html">kdocktabgroup</option>, <option value="classKDockWidget.html">kdockwidget</option>, <option value="classKDockWidgetAbstractHeader.html">kdockwidgetabstractheader</option>, <option value="classKDockWidgetAbstractHeaderDrag.html">kdockwidgetabstractheaderdrag</option>, <option value="classKDockWidgetHeader.html">kdockwidgetheader</option>, <option value="classKDockWidgetHeaderDrag.html">kdockwidgetheaderdrag</option>, <option value="classKDockWidgetPrivate.html">kdockwidgetprivate</option>, <option value="classKDockWindow.html">kdockwindow</option>, <option value="classKDoubleNumInput.html">kdoublenuminput</option>, <option value="classKDoubleSpinBox.html">kdoublespinbox</option>, <option value="classKDoubleValidator.html">kdoublevalidator</option>, <option value="classKDualColorButton.html">kdualcolorbutton</option>, <option value="classKEdit.html">kedit</option>, <option value="classKEditListBox.html">keditlistbox</option>, <option value="classKEditListBox_1_1CustomEditor.html">keditlistbox::customeditor</option>, <option value="classKEditToolbar.html">kedittoolbar</option>, <option value="classKEditToolbarWidget.html">kedittoolbarwidget</option>, <option value="classKFloatValidator.html">kfloatvalidator</option>, <option value="classKFontChooser.html">kfontchooser</option>, <option value="classKFontCombo.html">kfontcombo</option>, <option value="classKFontDialog.html">kfontdialog</option>, <option value="classKFontRequester.html">kfontrequester</option>, <option value="classKGradientSelector.html">kgradientselector</option>, <option value="classKGuiItem.html">kguiitem</option>, <option value="classKHelpMenu.html">khelpmenu</option>, <option value="classKHistoryCombo.html">khistorycombo</option>, <option value="classKHSSelector.html">khsselector</option>, <option value="classKIconView.html">kiconview</option>, <option value="classKIconViewItem.html">kiconviewitem</option>, <option value="classKIconViewSearchLine.html">kiconviewsearchline</option>, <option value="classKImageTrackLabel.html">kimagetracklabel</option>, <option value="classKInputDialog.html">kinputdialog</option>, <option value="classKIntNumInput.html">kintnuminput</option>, <option value="classKIntSpinBox.html">kintspinbox</option>, <option value="classKIntValidator.html">kintvalidator</option>, <option value="classKJanusWidget.html">kjanuswidget</option>, <option value="classKKeyButton.html">kkeybutton</option>, <option value="classKKeyChooser.html">kkeychooser</option>, <option value="classKKeyDialog.html">kkeydialog</option>, <option value="classKLanguageButton.html">klanguagebutton</option>, <option value="classKLed.html">kled</option>, <option value="classKLineEdit.html">klineedit</option>, <option value="classKLineEditDlg.html">klineeditdlg</option>, <option value="classKListAction.html">klistaction</option>, <option value="classKListBox.html">klistbox</option>, <option value="classKListView.html">klistview</option>, <option value="classKListViewItem.html">klistviewitem</option>, <option value="classKListViewLineEdit.html">klistviewlineedit</option>, <option value="classKListViewSearchLine.html">klistviewsearchline</option>, <option value="classKListViewSearchLineWidget.html">klistviewsearchlinewidget</option>, <option value="classKMacroCommand.html">kmacrocommand</option>, <option value="classKMainWindow.html">kmainwindow</option>, <option value="classKMainWindowInterface.html">kmainwindowinterface</option>, <option value="classKMenuBar.html">kmenubar</option>, <option value="classKMessageBox.html">kmessagebox</option>, <option value="classKMimeTypeValidator.html">kmimetypevalidator</option>, <option value="classKNamedCommand.html">knamedcommand</option>, <option value="classKNumInput.html">knuminput</option>, <option value="classKPaletteTable.html">kpalettetable</option>, <option value="classKPanelApplet.html">kpanelapplet</option>, <option value="classKPanelAppMenu.html">kpanelappmenu</option>, <option value="classKPanelExtension.html">kpanelextension</option>, <option value="classKPanelMenu.html">kpanelmenu</option>, <option value="classKPassivePopup.html">kpassivepopup</option>, <option value="classKPasswordDialog.html">kpassworddialog</option>, <option value="classKPasswordEdit.html">kpasswordedit</option>, <option value="classKPasteTextAction.html">kpastetextaction</option>, <option value="classKPixmapIO.html">kpixmapio</option>, <option value="classKPixmapRegionSelectorDialog.html">kpixmapregionselectordialog</option>, <option value="classKPixmapRegionSelectorWidget.html">kpixmapregionselectorwidget</option>, <option value="classKPopupFrame.html">kpopupframe</option>, <option value="classKPopupMenu.html">kpopupmenu</option>, <option value="classKPopupTitle.html">kpopuptitle</option>, <option value="classKProgress.html">kprogress</option>, <option value="classKProgressDialog.html">kprogressdialog</option>, <option value="classKPushButton.html">kpushbutton</option>, <option value="classKRadioAction.html">kradioaction</option>, <option value="classKRecentFilesAction.html">krecentfilesaction</option>, <option value="classKRestrictedLine.html">krestrictedline</option>, <option value="classKRootPermsIcon.html">krootpermsicon</option>, <option value="classKRootPixmap.html">krootpixmap</option>, <option value="classKRuler.html">kruler</option>, <option value="classKScrollView.html">kscrollview</option>, <option value="classKSelectAction.html">kselectaction</option>, <option value="classKSelector.html">kselector</option>, <option value="classKSeparator.html">kseparator</option>, <option value="classKShortcutDialog.html">kshortcutdialog</option>, <option value="classKSpell.html">kspell</option>, <option value="classKSpellConfig.html">kspellconfig</option>, <option value="classKSplashScreen.html">ksplashscreen</option>, <option value="classKSqueezedTextLabel.html">ksqueezedtextlabel</option>, <option value="classKStatusBar.html">kstatusbar</option>, <option value="classKStatusBarLabel.html">kstatusbarlabel</option>, <option value="classKStdGuiItem.html">kstdguiitem</option>, <option value="classKStringListValidator.html">kstringlistvalidator</option>, <option value="classKSwitchLanguageDialog.html">kswitchlanguagedialog</option>, <option value="classKSyntaxHighlighter.html">ksyntaxhighlighter</option>, <option value="classKSystemTray.html">ksystemtray</option>, <option value="classKTabBar.html">ktabbar</option>, <option value="classKTabCtl.html">ktabctl</option>, <option value="classKTabWidget.html">ktabwidget</option>, <option value="classKTextBrowser.html">ktextbrowser</option>, <option value="classKTextEdit.html">ktextedit</option>, <option value="classKTimeWidget.html">ktimewidget</option>, <option value="classKTimezoneWidget.html">ktimezonewidget</option>, <option value="classKTipDatabase.html">ktipdatabase</option>, <option value="classKTipDialog.html">ktipdialog</option>, <option value="classKToggleAction.html">ktoggleaction</option>, <option value="classKToggleFullScreenAction.html">ktogglefullscreenaction</option>, <option value="classKToggleToolBarAction.html">ktoggletoolbaraction</option>, <option value="classKToolBar.html">ktoolbar</option>, <option value="classKToolBarButton.html">ktoolbarbutton</option>, <option value="classKToolBarButtonList.html">ktoolbarbuttonlist</option>, <option value="classKToolBarLabelAction.html">ktoolbarlabelaction</option>, <option value="classKToolBarPopupAction.html">ktoolbarpopupaction</option>, <option value="classKToolBarRadioGroup.html">ktoolbarradiogroup</option>, <option value="classKURLLabel.html">kurllabel</option>, <option value="classKValueSelector.html">kvalueselector</option>, <option value="classKWidgetAction.html">kwidgetaction</option>, <option value="classKWindowInfo.html">kwindowinfo</option>, <option value="classKWizard.html">kwizard</option>, <option value="classKWordWrap.html">kwordwrap</option>, <option value="classKWritePermsIcon.html">kwritepermsicon</option>, <option value="classKXMLGUIBuilder.html">kxmlguibuilder</option>, <option value="classKXMLGUIClient.html">kxmlguiclient</option>, <option value="classKXMLGUIFactory.html">kxmlguifactory</option>, <option value="classKXYSelector.html">kxyselector</option>,
</select>
</form>
</div>
-->
</div></div>
<div class="menu_box"><h2>API Dox</h2>
<div class="nav_list">
<ul>
<li><a href="../../arts/html/index.html">arts</a></li><li><a href="../../dcop/html/index.html">dcop</a></li><li><a href="../../dnssd/html/index.html">dnssd</a></li><li><a href="../../interfaces/html/index.html">interfaces</a></li><li> <a href="../../interfaces/kimproxy/interface/html/index.html">interface</a></li><li> <a href="../../interfaces/kimproxy/library/html/index.html">library</a></li><li> <a href="../../interfaces/kspeech/html/index.html">kspeech</a></li><li> <a href="../../interfaces/ktexteditor/html/index.html">ktexteditor</a></li><li><a href="../../kabc/html/index.html">kabc</a></li><li><a href="../../kate/html/index.html">kate</a></li><li><a href="../../kcmshell/html/index.html">kcmshell</a></li><li><a href="../../kdecore/html/index.html">kdecore</a></li><li><a href="../../kded/html/index.html">kded</a></li><li><a href="../../kdefx/html/index.html">kdefx</a></li><li><a href="../../kdeprint/html/index.html">kdeprint</a></li><li><a href="../../kdesu/html/index.html">kdesu</a></li><li><a href="../../kdeui/html/index.html">kdeui</a></li><li><a href="../../kdoctools/html/index.html">kdoctools</a></li><li><a href="../../khtml/html/index.html">khtml</a></li><li><a href="../../kimgio/html/index.html">kimgio</a></li><li><a href="../../kinit/html/index.html">kinit</a></li><li><a href="../../kio/html/index.html">kio</a></li><li> <a href="../../kio/bookmarks/html/index.html">bookmarks</a></li><li> <a href="../../kio/httpfilter/html/index.html">httpfilter</a></li><li> <a href="../../kio/kfile/html/index.html">kfile</a></li><li> <a href="../../kio/kio/html/index.html">kio</a></li><li> <a href="../../kio/kioexec/html/index.html">kioexec</a></li><li> <a href="../../kio/kpasswdserver/html/index.html">kpasswdserver</a></li><li> <a href="../../kio/kssl/html/index.html">kssl</a></li><li><a href="../../kioslave/html/index.html">kioslave</a></li><li> <a href="../../kioslave/http/html/index.html">http</a></li><li><a href="../../kjs/html/index.html">kjs</a></li><li><a href="../../kmdi/html/index.html">kmdi</a></li><li> <a href="../../kmdi/kmdi/html/index.html">kmdi</a></li><li><a href="../../knewstuff/html/index.html">knewstuff</a></li><li><a href="../../kparts/html/index.html">kparts</a></li><li><a href="../../kresources/html/index.html">kresources</a></li><li><a href="../../kspell2/html/index.html">kspell2</a></li><li><a href="../../kunittest/html/index.html">kunittest</a></li><li><a href="../../kutils/html/index.html">kutils</a></li><li><a href="../../kwallet/html/index.html">kwallet</a></li><li><a href="../../libkmid/html/index.html">libkmid</a></li><li><a href="../../libkscreensaver/html/index.html">libkscreensaver</a></li>
</ul></div></div>
</td>
</tr>
</table>
<span class="doNotDisplay">
<a href="http://www.kde.org/" accesskey="8">KDE Home</a> |
<a href="http://accessibility.kde.org/" accesskey="9">KDE Accessibility Home</a> |
<a href="http://www.kde.org/media/accesskeys.php" accesskey="0">Description of Access Keys</a>
</span>
<div style="height: 8px"></div>
<div id="footer">
<div id="footer_left">
Maintained by <a href="mailto:groot@kde.org">Adriaan de Groot</a>
and
<a href="mailto:winter@kde.org">Allen Winter</a>.
<br/>
KDE and K Desktop Environment are trademarks of <a href="http://www.kde.org/areas/kde-ev/" title="Homepage of the KDE non-profit Organization">KDE e.V.</a> |
<a href="http://www.kde.org/contact/impressum.php">Legal</a>
</div>
<div id="footer_right"><img src="/media/images/footer_right.png" style="margin: 0px" alt="" /></div>
</div>
<!--
WARNING: DO NOT SEND MAIL TO THE FOLLOWING EMAIL ADDRESS! YOU WILL
BE BLOCKED INSTANTLY AND PERMANENTLY!
<a href="mailto:aaaatrap-425acc3b5374943f@kde.org">Block me</a>
WARNING END
-->
</body>
</html>
