<?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" xml:lang="en">
<head>
<title>uniqueapphandler.cpp Source File</title>
<style type="text/css">
.cp-doNotDisplay { display: none; }
@media aural, braille, handheld, tty { .cp-doNotDisplay { display: inline; speak: normal; }}
.cp-edit { text-align: right; }
@media print, embossed { .cp-edit { display: none; }}
</style>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta http-equiv="Content-Style-Type" content="text/css" />
<link rel="meta" href="http://www.kde.org/labels.rdf" type="application/rdf+xml" title="ICRA labels" />
<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" />
<meta name="no-email-collection" content="http://www.unspam.com/noemailcollection" />
<script type="text/javascript" src="jquery.js"></script>
<script type="text/javascript" src="dynsections.js"></script>
<link rel="shortcut icon" href="../../favicon.ico" /><link rel="icon" href="../../favicon.ico" />
<link rel="stylesheet" media="screen" type="text/css" title="KDE Colors" href="../../kde.css" />
<link rel="stylesheet" media="print, embossed" type="text/css" href="../../print.css" />
<link rel="stylesheet" media="screen, aural, handheld, tty, braille" type="text/css" title="Flat" href="../../flat.css" />
<link rel="stylesheet" type="text/css" href="../../doxygen.css" />
<link rel="stylesheet" type="text/css" href="../../tabs.css" />
</head>
<body>
<ul class="cp-doNotDisplay">
<li><a href="#cp-content" accesskey="2">Skip to content</a></li>
<li><a href="#cp-menu" accesskey="5">Skip to link menu</a></li>
</ul>
<div id="container">
<div id="header">
<div id="header_top"><div><div>
<img alt ="" src="../../top-kde.jpg"/>
</div></div></div>
<div id="header_bottom">
<div id="location">
<ul>
<li><a href="http://api.kde.org">KDE API Reference</a></li>
<li><a href="../../index.html">kdepimlibs-4.10.5 API Reference</a></li>
</ul>
</div>
<div id="menu">
<ul>
<li><a href="http://www.kde.org/">KDE Home</a></li>
<li><a href="http://kde.org/contact/">Contact Us</a></li>
</ul>
</div>
</div>
</div>
<!-- End page header -->
<div id="body_wrapper">
<div id="body">
<!-- begin main content -->
<div id="right">
<div class="content">
<div id="main">
<div class="clearer"> </div>
<h2><a name="content"></a>Kontact Plugin Interface Library</h2>
<!-- BC -->
<div id="top">
<!-- Generated by Doxygen 1.8.3.1 -->
<div id="nav-path" class="navpath">
<ul>
<li class="navelem"><a class="el" href="dir_6406e5da9a233fdd96775e770c379dc7.html">kontactinterface</a></li> </ul>
</div>
</div><!-- top -->
<div class="header">
<div class="headertitle">
<div class="title">uniqueapphandler.cpp</div> </div>
</div><!--header-->
<div class="contents">
<div class="fragment"><div class="line"><a name="l00001"></a><span class="lineno"> 1</span> <span class="comment">/*</span></div>
<div class="line"><a name="l00002"></a><span class="lineno"> 2</span> <span class="comment"> This file is part of the KDE Kontact Plugin Interface Library.</span></div>
<div class="line"><a name="l00003"></a><span class="lineno"> 3</span> <span class="comment"></span></div>
<div class="line"><a name="l00004"></a><span class="lineno"> 4</span> <span class="comment"> Copyright (c) 2003,2008 David Faure <faure@kde.org></span></div>
<div class="line"><a name="l00005"></a><span class="lineno"> 5</span> <span class="comment"></span></div>
<div class="line"><a name="l00006"></a><span class="lineno"> 6</span> <span class="comment"> This library is free software; you can redistribute it and/or</span></div>
<div class="line"><a name="l00007"></a><span class="lineno"> 7</span> <span class="comment"> modify it under the terms of the GNU Library General Public</span></div>
<div class="line"><a name="l00008"></a><span class="lineno"> 8</span> <span class="comment"> License as published by the Free Software Foundation; either</span></div>
<div class="line"><a name="l00009"></a><span class="lineno"> 9</span> <span class="comment"> version 2 of the License, or (at your option) any later version.</span></div>
<div class="line"><a name="l00010"></a><span class="lineno"> 10</span> <span class="comment"></span></div>
<div class="line"><a name="l00011"></a><span class="lineno"> 11</span> <span class="comment"> This library is distributed in the hope that it will be useful,</span></div>
<div class="line"><a name="l00012"></a><span class="lineno"> 12</span> <span class="comment"> but WITHOUT ANY WARRANTY; without even the implied warranty of</span></div>
<div class="line"><a name="l00013"></a><span class="lineno"> 13</span> <span class="comment"> MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU</span></div>
<div class="line"><a name="l00014"></a><span class="lineno"> 14</span> <span class="comment"> Library General Public License for more details.</span></div>
<div class="line"><a name="l00015"></a><span class="lineno"> 15</span> <span class="comment"></span></div>
<div class="line"><a name="l00016"></a><span class="lineno"> 16</span> <span class="comment"> You should have received a copy of the GNU Library General Public License</span></div>
<div class="line"><a name="l00017"></a><span class="lineno"> 17</span> <span class="comment"> along with this library; see the file COPYING.LIB. If not, write to</span></div>
<div class="line"><a name="l00018"></a><span class="lineno"> 18</span> <span class="comment"> the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,</span></div>
<div class="line"><a name="l00019"></a><span class="lineno"> 19</span> <span class="comment"> Boston, MA 02110-1301, USA.</span></div>
<div class="line"><a name="l00020"></a><span class="lineno"> 20</span> <span class="comment">*/</span></div>
<div class="line"><a name="l00021"></a><span class="lineno"> 21</span> </div>
<div class="line"><a name="l00022"></a><span class="lineno"> 22</span> <span class="preprocessor">#include "uniqueapphandler.h"</span></div>
<div class="line"><a name="l00023"></a><span class="lineno"> 23</span> <span class="preprocessor">#include <qdbusabstractadaptor.h></span></div>
<div class="line"><a name="l00024"></a><span class="lineno"> 24</span> <span class="preprocessor">#include "core.h"</span></div>
<div class="line"><a name="l00025"></a><span class="lineno"> 25</span> </div>
<div class="line"><a name="l00026"></a><span class="lineno"> 26</span> <span class="preprocessor">#include <kpimutils/processes.h></span></div>
<div class="line"><a name="l00027"></a><span class="lineno"> 27</span> </div>
<div class="line"><a name="l00028"></a><span class="lineno"> 28</span> <span class="preprocessor">#include <kapplication.h></span></div>
<div class="line"><a name="l00029"></a><span class="lineno"> 29</span> <span class="preprocessor">#include <kcmdlineargs.h></span></div>
<div class="line"><a name="l00030"></a><span class="lineno"> 30</span> <span class="preprocessor">#include <kdebug.h></span></div>
<div class="line"><a name="l00031"></a><span class="lineno"> 31</span> <span class="preprocessor">#include <kstartupinfo.h></span></div>
<div class="line"><a name="l00032"></a><span class="lineno"> 32</span> <span class="preprocessor">#include <kuniqueapplication.h></span></div>
<div class="line"><a name="l00033"></a><span class="lineno"> 33</span> <span class="preprocessor">#include <kwindowsystem.h></span></div>
<div class="line"><a name="l00034"></a><span class="lineno"> 34</span> </div>
<div class="line"><a name="l00035"></a><span class="lineno"> 35</span> <span class="preprocessor">#include <QDBusConnection></span></div>
<div class="line"><a name="l00036"></a><span class="lineno"> 36</span> <span class="preprocessor">#include <QDBusConnectionInterface></span></div>
<div class="line"><a name="l00037"></a><span class="lineno"> 37</span> </div>
<div class="line"><a name="l00038"></a><span class="lineno"> 38</span> <span class="preprocessor">#ifdef Q_WS_WIN</span></div>
<div class="line"><a name="l00039"></a><span class="lineno"> 39</span> <span class="preprocessor"></span><span class="preprocessor"># include <process.h></span></div>
<div class="line"><a name="l00040"></a><span class="lineno"> 40</span> <span class="preprocessor">#endif</span></div>
<div class="line"><a name="l00041"></a><span class="lineno"> 41</span> <span class="preprocessor"></span></div>
<div class="line"><a name="l00042"></a><span class="lineno"> 42</span> <span class="comment">/*</span></div>
<div class="line"><a name="l00043"></a><span class="lineno"> 43</span> <span class="comment"> Test plan for the various cases of interaction between standalone apps and kontact:</span></div>
<div class="line"><a name="l00044"></a><span class="lineno"> 44</span> <span class="comment"></span></div>
<div class="line"><a name="l00045"></a><span class="lineno"> 45</span> <span class="comment"> 1) start kontact, select "Mail".</span></div>
<div class="line"><a name="l00046"></a><span class="lineno"> 46</span> <span class="comment"> 1a) type "korganizer" -> it switches to korganizer</span></div>
<div class="line"><a name="l00047"></a><span class="lineno"> 47</span> <span class="comment"> 1b) type "kmail" -> it switches to kmail</span></div>
<div class="line"><a name="l00048"></a><span class="lineno"> 48</span> <span class="comment"> 1c) type "kaddressbook" -> it switches to kaddressbook</span></div>
<div class="line"><a name="l00049"></a><span class="lineno"> 49</span> <span class="comment"> 1d) type "kmail foo@kde.org" -> it opens a kmail composer, without switching</span></div>
<div class="line"><a name="l00050"></a><span class="lineno"> 50</span> <span class="comment"> 1e) type "knode" -> it switches to knode [unless configured to be external]</span></div>
<div class="line"><a name="l00051"></a><span class="lineno"> 51</span> <span class="comment"> 1f) type "kaddressbook --new-contact" -> it opens a kaddressbook contact window</span></div>
<div class="line"><a name="l00052"></a><span class="lineno"> 52</span> <span class="comment"> 1g) type "knode news://foobar/group" -> it pops up "can't resolve hostname"</span></div>
<div class="line"><a name="l00053"></a><span class="lineno"> 53</span> <span class="comment"></span></div>
<div class="line"><a name="l00054"></a><span class="lineno"> 54</span> <span class="comment"> 2) close kontact. Launch kmail. Launch kontact again.</span></div>
<div class="line"><a name="l00055"></a><span class="lineno"> 55</span> <span class="comment"> 2a) click "Mail" icon -> kontact doesn't load a part, but activates the kmail window</span></div>
<div class="line"><a name="l00056"></a><span class="lineno"> 56</span> <span class="comment"> 2b) type "kmail foo@kde.org" -> standalone kmail opens composer.</span></div>
<div class="line"><a name="l00057"></a><span class="lineno"> 57</span> <span class="comment"> 2c) close kmail, click "Mail" icon -> kontact loads the kmail part.</span></div>
<div class="line"><a name="l00058"></a><span class="lineno"> 58</span> <span class="comment"> 2d) type "kmail" -> kontact is brought to front</span></div>
<div class="line"><a name="l00059"></a><span class="lineno"> 59</span> <span class="comment"></span></div>
<div class="line"><a name="l00060"></a><span class="lineno"> 60</span> <span class="comment"> 3) close kontact. Launch korganizer, then kontact.</span></div>
<div class="line"><a name="l00061"></a><span class="lineno"> 61</span> <span class="comment"> 3a) both Todo and Calendar activate the running korganizer.</span></div>
<div class="line"><a name="l00062"></a><span class="lineno"> 62</span> <span class="comment"> 3b) type "korganizer" -> standalone korganizer is brought to front</span></div>
<div class="line"><a name="l00063"></a><span class="lineno"> 63</span> <span class="comment"> 3c) close korganizer, click Calendar or Todo -> kontact loads part.</span></div>
<div class="line"><a name="l00064"></a><span class="lineno"> 64</span> <span class="comment"> 3d) type "korganizer" -> kontact is brought to front</span></div>
<div class="line"><a name="l00065"></a><span class="lineno"> 65</span> <span class="comment"></span></div>
<div class="line"><a name="l00066"></a><span class="lineno"> 66</span> <span class="comment"> 4) close kontact. Launch kaddressbook, then kontact.</span></div>
<div class="line"><a name="l00067"></a><span class="lineno"> 67</span> <span class="comment"> 4a) "Contacts" icon activate the running kaddressbook.</span></div>
<div class="line"><a name="l00068"></a><span class="lineno"> 68</span> <span class="comment"> 4b) type "kaddressbook" -> standalone kaddressbook is brought to front</span></div>
<div class="line"><a name="l00069"></a><span class="lineno"> 69</span> <span class="comment"> 4c) close kaddressbook, type "kaddressbook -a foo@kde.org" -> kontact loads part and opens editor</span></div>
<div class="line"><a name="l00070"></a><span class="lineno"> 70</span> <span class="comment"> 4d) type "kaddressbook" -> kontact is brought to front</span></div>
<div class="line"><a name="l00071"></a><span class="lineno"> 71</span> <span class="comment"></span></div>
<div class="line"><a name="l00072"></a><span class="lineno"> 72</span> <span class="comment"> 5) close kontact. Launch knode, then kontact.</span></div>
<div class="line"><a name="l00073"></a><span class="lineno"> 73</span> <span class="comment"> 5a) "News" icon activate the running knode.</span></div>
<div class="line"><a name="l00074"></a><span class="lineno"> 74</span> <span class="comment"> 5b) type "knode" -> standalone knode is brought to front</span></div>
<div class="line"><a name="l00075"></a><span class="lineno"> 75</span> <span class="comment"> 5c) close knode, type "knode news://foobar/group" -> kontact loads knode and pops up msgbox</span></div>
<div class="line"><a name="l00076"></a><span class="lineno"> 76</span> <span class="comment"> 5d) type "knode" -> kontact is brought to front</span></div>
<div class="line"><a name="l00077"></a><span class="lineno"> 77</span> <span class="comment"></span></div>
<div class="line"><a name="l00078"></a><span class="lineno"> 78</span> <span class="comment"> 6) start "kontact --module summaryplugin"</span></div>
<div class="line"><a name="l00079"></a><span class="lineno"> 79</span> <span class="comment"> 6a) type "qdbus org.kde.kmail /kmail_PimApplication newInstance '' ''" -></span></div>
<div class="line"><a name="l00080"></a><span class="lineno"> 80</span> <span class="comment"> kontact switches to kmail (#103775)</span></div>
<div class="line"><a name="l00081"></a><span class="lineno"> 81</span> <span class="comment"> 6b) type "kmail" -> kontact is brought to front</span></div>
<div class="line"><a name="l00082"></a><span class="lineno"> 82</span> <span class="comment"> 6c) type "kontact" -> kontact is brought to front</span></div>
<div class="line"><a name="l00083"></a><span class="lineno"> 83</span> <span class="comment"> 6d) type "kontact --module summaryplugin" -> kontact switches to summary</span></div>
<div class="line"><a name="l00084"></a><span class="lineno"> 84</span> <span class="comment"></span></div>
<div class="line"><a name="l00085"></a><span class="lineno"> 85</span> <span class="comment">*/</span></div>
<div class="line"><a name="l00086"></a><span class="lineno"> 86</span> </div>
<div class="line"><a name="l00087"></a><span class="lineno"> 87</span> <span class="keyword">using namespace </span>KontactInterface;</div>
<div class="line"><a name="l00088"></a><span class="lineno"> 88</span> </div>
<div class="line"><a name="l00089"></a><span class="lineno"> 89</span> <span class="comment">//@cond PRIVATE</span></div>
<div class="line"><a name="l00090"></a><span class="lineno"> 90</span> <span class="keyword">class </span>UniqueAppHandler::Private</div>
<div class="line"><a name="l00091"></a><span class="lineno"> 91</span> {</div>
<div class="line"><a name="l00092"></a><span class="lineno"> 92</span>  <span class="keyword">public</span>:</div>
<div class="line"><a name="l00093"></a><span class="lineno"> 93</span>  <a class="code" href="classKontactInterface_1_1Plugin.html" title="Base class for all Plugins in Kontact.">Plugin</a> *mPlugin;</div>
<div class="line"><a name="l00094"></a><span class="lineno"> 94</span> };</div>
<div class="line"><a name="l00095"></a><span class="lineno"> 95</span> <span class="comment">//@endcond</span></div>
<div class="line"><a name="l00096"></a><span class="lineno"> 96</span> </div>
<div class="line"><a name="l00097"></a><span class="lineno"> 97</span> UniqueAppHandler::UniqueAppHandler( <a class="code" href="classKontactInterface_1_1Plugin.html" title="Base class for all Plugins in Kontact.">Plugin</a> *plugin )</div>
<div class="line"><a name="l00098"></a><span class="lineno"> 98</span>  : QObject( plugin ), d( new Private )</div>
<div class="line"><a name="l00099"></a><span class="lineno"> 99</span> {</div>
<div class="line"><a name="l00100"></a><span class="lineno"> 100</span>  <span class="comment">//kDebug() << "plugin->objectName():" << plugin->objectName();</span></div>
<div class="line"><a name="l00101"></a><span class="lineno"> 101</span> </div>
<div class="line"><a name="l00102"></a><span class="lineno"> 102</span>  d->mPlugin = plugin;</div>
<div class="line"><a name="l00103"></a><span class="lineno"> 103</span>  QDBusConnection session = QDBusConnection::sessionBus();</div>
<div class="line"><a name="l00104"></a><span class="lineno"> 104</span>  <span class="keyword">const</span> QString appName = plugin->objectName();</div>
<div class="line"><a name="l00105"></a><span class="lineno"> 105</span>  session.registerService( <span class="stringliteral">"org.kde."</span> + appName );</div>
<div class="line"><a name="l00106"></a><span class="lineno"> 106</span>  <span class="keyword">const</span> QString objectName = QString( <span class="charliteral">'/'</span> ) + appName + <span class="stringliteral">"_PimApplication"</span>;</div>
<div class="line"><a name="l00107"></a><span class="lineno"> 107</span>  session.registerObject( objectName, <span class="keyword">this</span>, QDBusConnection::ExportAllSlots );</div>
<div class="line"><a name="l00108"></a><span class="lineno"> 108</span> }</div>
<div class="line"><a name="l00109"></a><span class="lineno"> 109</span> </div>
<div class="line"><a name="l00110"></a><span class="lineno"> 110</span> UniqueAppHandler::~UniqueAppHandler()</div>
<div class="line"><a name="l00111"></a><span class="lineno"> 111</span> {</div>
<div class="line"><a name="l00112"></a><span class="lineno"> 112</span>  QDBusConnection session = QDBusConnection::sessionBus();</div>
<div class="line"><a name="l00113"></a><span class="lineno"> 113</span>  <span class="keyword">const</span> QString appName = parent()->objectName();</div>
<div class="line"><a name="l00114"></a><span class="lineno"> 114</span>  session.unregisterService( <span class="stringliteral">"org.kde."</span> + appName );</div>
<div class="line"><a name="l00115"></a><span class="lineno"> 115</span>  <span class="keyword">delete</span> d;</div>
<div class="line"><a name="l00116"></a><span class="lineno"> 116</span> }</div>
<div class="line"><a name="l00117"></a><span class="lineno"> 117</span> </div>
<div class="line"><a name="l00118"></a><span class="lineno"> 118</span> <span class="comment">// DBUS call</span></div>
<div class="line"><a name="l00119"></a><span class="lineno"> 119</span> <span class="keywordtype">int</span> UniqueAppHandler::newInstance( <span class="keyword">const</span> QByteArray &asn_id, <span class="keyword">const</span> QByteArray &args )</div>
<div class="line"><a name="l00120"></a><span class="lineno"> 120</span> {</div>
<div class="line"><a name="l00121"></a><span class="lineno"> 121</span>  <span class="keywordflow">if</span> ( !asn_id.isEmpty() ) {</div>
<div class="line"><a name="l00122"></a><span class="lineno"> 122</span>  kapp->setStartupId( asn_id );</div>
<div class="line"><a name="l00123"></a><span class="lineno"> 123</span>  }</div>
<div class="line"><a name="l00124"></a><span class="lineno"> 124</span> </div>
<div class="line"><a name="l00125"></a><span class="lineno"> 125</span>  KCmdLineArgs::reset(); <span class="comment">// forget options defined by other "applications"</span></div>
<div class="line"><a name="l00126"></a><span class="lineno"> 126</span>  <a class="code" href="classKontactInterface_1_1UniqueAppHandler.html#a5875a217e1f0dafbef2c5c2fbad8e3c9" title="This must be reimplemented so that app-specific command line options can be parsed.">loadCommandLineOptions</a>(); <span class="comment">// implemented by plugin</span></div>
<div class="line"><a name="l00127"></a><span class="lineno"> 127</span> </div>
<div class="line"><a name="l00128"></a><span class="lineno"> 128</span>  <span class="comment">// This bit is duplicated from KUniqueApplicationAdaptor::newInstance()</span></div>
<div class="line"><a name="l00129"></a><span class="lineno"> 129</span>  QDataStream ds( args );</div>
<div class="line"><a name="l00130"></a><span class="lineno"> 130</span>  KCmdLineArgs::loadAppArgs( ds );</div>
<div class="line"><a name="l00131"></a><span class="lineno"> 131</span> </div>
<div class="line"><a name="l00132"></a><span class="lineno"> 132</span>  <span class="keywordflow">return</span> newInstance();</div>
<div class="line"><a name="l00133"></a><span class="lineno"> 133</span> }</div>
<div class="line"><a name="l00134"></a><span class="lineno"> 134</span> </div>
<div class="line"><a name="l00135"></a><span class="lineno"> 135</span> <span class="keyword">static</span> QWidget *s_mainWidget = 0;</div>
<div class="line"><a name="l00136"></a><span class="lineno"> 136</span> </div>
<div class="line"><a name="l00137"></a><span class="lineno"> 137</span> <span class="comment">// Plugin-specific newInstance implementation, called by above method</span></div>
<div class="line"><a name="l00138"></a><span class="lineno"> 138</span> <span class="keywordtype">int</span> KontactInterface::UniqueAppHandler::newInstance()</div>
<div class="line"><a name="l00139"></a><span class="lineno"> 139</span> {</div>
<div class="line"><a name="l00140"></a><span class="lineno"> 140</span>  <span class="keywordflow">if</span> ( s_mainWidget ) {</div>
<div class="line"><a name="l00141"></a><span class="lineno"> 141</span>  s_mainWidget->show();</div>
<div class="line"><a name="l00142"></a><span class="lineno"> 142</span>  KWindowSystem::forceActiveWindow( s_mainWidget->winId() );</div>
<div class="line"><a name="l00143"></a><span class="lineno"> 143</span>  KStartupInfo::appStarted();</div>
<div class="line"><a name="l00144"></a><span class="lineno"> 144</span>  }</div>
<div class="line"><a name="l00145"></a><span class="lineno"> 145</span> </div>
<div class="line"><a name="l00146"></a><span class="lineno"> 146</span>  <span class="comment">// Then ensure the part appears in kontact</span></div>
<div class="line"><a name="l00147"></a><span class="lineno"> 147</span>  d->mPlugin->core()->selectPlugin( d->mPlugin );</div>
<div class="line"><a name="l00148"></a><span class="lineno"> 148</span>  <span class="keywordflow">return</span> 0;</div>
<div class="line"><a name="l00149"></a><span class="lineno"> 149</span> }</div>
<div class="line"><a name="l00150"></a><span class="lineno"> 150</span> </div>
<div class="line"><a name="l00151"></a><span class="lineno"> 151</span> <a class="code" href="classKontactInterface_1_1Plugin.html" title="Base class for all Plugins in Kontact.">Plugin</a> *UniqueAppHandler::plugin()<span class="keyword"> const</span></div>
<div class="line"><a name="l00152"></a><span class="lineno"> 152</span> <span class="keyword"></span>{</div>
<div class="line"><a name="l00153"></a><span class="lineno"> 153</span>  <span class="keywordflow">return</span> d->mPlugin;</div>
<div class="line"><a name="l00154"></a><span class="lineno"> 154</span> }</div>
<div class="line"><a name="l00155"></a><span class="lineno"> 155</span> </div>
<div class="line"><a name="l00156"></a><span class="lineno"> 156</span> <span class="keywordtype">bool</span> KontactInterface::UniqueAppHandler::load()</div>
<div class="line"><a name="l00157"></a><span class="lineno"> 157</span> {</div>
<div class="line"><a name="l00158"></a><span class="lineno"> 158</span>  (void)d->mPlugin->part(); <span class="comment">// load the part without bringing it to front</span></div>
<div class="line"><a name="l00159"></a><span class="lineno"> 159</span>  <span class="keywordflow">return</span> <span class="keyword">true</span>;</div>
<div class="line"><a name="l00160"></a><span class="lineno"> 160</span> }</div>
<div class="line"><a name="l00161"></a><span class="lineno"> 161</span> </div>
<div class="line"><a name="l00162"></a><span class="lineno"> 162</span> <span class="comment">//@cond PRIVATE</span></div>
<div class="line"><a name="l00163"></a><span class="lineno"> 163</span> <span class="keyword">class </span>UniqueAppWatcher::Private</div>
<div class="line"><a name="l00164"></a><span class="lineno"> 164</span> {</div>
<div class="line"><a name="l00165"></a><span class="lineno"> 165</span>  <span class="keyword">public</span>:</div>
<div class="line"><a name="l00166"></a><span class="lineno"> 166</span>  <a class="code" href="classKontactInterface_1_1UniqueAppHandlerFactoryBase.html" title="Base class for UniqueAppHandler.">UniqueAppHandlerFactoryBase</a> *mFactory;</div>
<div class="line"><a name="l00167"></a><span class="lineno"> 167</span>  <a class="code" href="classKontactInterface_1_1Plugin.html" title="Base class for all Plugins in Kontact.">Plugin</a> *mPlugin;</div>
<div class="line"><a name="l00168"></a><span class="lineno"> 168</span>  <span class="keywordtype">bool</span> mRunningStandalone;</div>
<div class="line"><a name="l00169"></a><span class="lineno"> 169</span> };</div>
<div class="line"><a name="l00170"></a><span class="lineno"> 170</span> <span class="comment">//@endcond</span></div>
<div class="line"><a name="l00171"></a><span class="lineno"> 171</span> </div>
<div class="line"><a name="l00172"></a><span class="lineno"><a class="code" href="classKontactInterface_1_1UniqueAppWatcher.html#a6dc3acc56ffa85710166ab2aff21a4a4"> 172</a></span> <a class="code" href="classKontactInterface_1_1UniqueAppWatcher.html#a6dc3acc56ffa85710166ab2aff21a4a4" title="Create an instance of UniqueAppWatcher, which does everything necessary for the "unique application" ...">UniqueAppWatcher::UniqueAppWatcher</a>( <a class="code" href="classKontactInterface_1_1UniqueAppHandlerFactoryBase.html" title="Base class for UniqueAppHandler.">UniqueAppHandlerFactoryBase</a> *factory, <a class="code" href="classKontactInterface_1_1Plugin.html" title="Base class for all Plugins in Kontact.">Plugin</a> *plugin )</div>
<div class="line"><a name="l00173"></a><span class="lineno"> 173</span>  : QObject( plugin ), d( new Private )</div>
<div class="line"><a name="l00174"></a><span class="lineno"> 174</span> {</div>
<div class="line"><a name="l00175"></a><span class="lineno"> 175</span>  d->mFactory = factory;</div>
<div class="line"><a name="l00176"></a><span class="lineno"> 176</span>  d->mPlugin = plugin;</div>
<div class="line"><a name="l00177"></a><span class="lineno"> 177</span> </div>
<div class="line"><a name="l00178"></a><span class="lineno"> 178</span>  <span class="comment">// The app is running standalone if 1) that name is known to D-Bus</span></div>
<div class="line"><a name="l00179"></a><span class="lineno"> 179</span>  <span class="keyword">const</span> QString serviceName = <span class="stringliteral">"org.kde."</span> + plugin->objectName();</div>
<div class="line"><a name="l00180"></a><span class="lineno"> 180</span>  <span class="comment">//Needed for wince build</span></div>
<div class="line"><a name="l00181"></a><span class="lineno"> 181</span> <span class="preprocessor"> #undef interface</span></div>
<div class="line"><a name="l00182"></a><span class="lineno"> 182</span> <span class="preprocessor"></span> d->mRunningStandalone =</div>
<div class="line"><a name="l00183"></a><span class="lineno"> 183</span>  QDBusConnection::sessionBus().interface()->isServiceRegistered( serviceName );</div>
<div class="line"><a name="l00184"></a><span class="lineno"> 184</span> <span class="preprocessor">#ifdef Q_WS_WIN</span></div>
<div class="line"><a name="l00185"></a><span class="lineno"> 185</span> <span class="preprocessor"></span> <span class="keywordflow">if</span> ( d->mRunningStandalone ) {</div>
<div class="line"><a name="l00186"></a><span class="lineno"> 186</span>  QList<int> pids;</div>
<div class="line"><a name="l00187"></a><span class="lineno"> 187</span>  KPIMUtils::getProcessesIdForName( plugin->objectName(), pids );</div>
<div class="line"><a name="l00188"></a><span class="lineno"> 188</span>  <span class="keyword">const</span> <span class="keywordtype">int</span> mypid = getpid();</div>
<div class="line"><a name="l00189"></a><span class="lineno"> 189</span>  <span class="keywordtype">bool</span> processExits = <span class="keyword">false</span>;</div>
<div class="line"><a name="l00190"></a><span class="lineno"> 190</span>  <span class="keywordflow">foreach</span> ( <span class="keywordtype">int</span> pid, pids ) {</div>
<div class="line"><a name="l00191"></a><span class="lineno"> 191</span>  <span class="keywordflow">if</span> ( mypid != pid ) {</div>
<div class="line"><a name="l00192"></a><span class="lineno"> 192</span>  processExits = <span class="keyword">true</span>;</div>
<div class="line"><a name="l00193"></a><span class="lineno"> 193</span>  <span class="keywordflow">break</span>;</div>
<div class="line"><a name="l00194"></a><span class="lineno"> 194</span>  }</div>
<div class="line"><a name="l00195"></a><span class="lineno"> 195</span>  }</div>
<div class="line"><a name="l00196"></a><span class="lineno"> 196</span>  <span class="keywordflow">if</span> ( !processExits ) {</div>
<div class="line"><a name="l00197"></a><span class="lineno"> 197</span>  d->mRunningStandalone = <span class="keyword">false</span>;</div>
<div class="line"><a name="l00198"></a><span class="lineno"> 198</span>  }</div>
<div class="line"><a name="l00199"></a><span class="lineno"> 199</span>  }</div>
<div class="line"><a name="l00200"></a><span class="lineno"> 200</span> <span class="preprocessor">#endif</span></div>
<div class="line"><a name="l00201"></a><span class="lineno"> 201</span> <span class="preprocessor"></span></div>
<div class="line"><a name="l00202"></a><span class="lineno"> 202</span>  QString owner = QDBusConnection::sessionBus().interface()->serviceOwner( serviceName );</div>
<div class="line"><a name="l00203"></a><span class="lineno"> 203</span>  <span class="keywordflow">if</span> ( d->mRunningStandalone && ( owner == QDBusConnection::sessionBus().baseService() ) ) {</div>
<div class="line"><a name="l00204"></a><span class="lineno"> 204</span>  d->mRunningStandalone = <span class="keyword">false</span>;</div>
<div class="line"><a name="l00205"></a><span class="lineno"> 205</span>  }</div>
<div class="line"><a name="l00206"></a><span class="lineno"> 206</span>  <span class="comment">//kDebug() << " plugin->objectName()=" << plugin->objectName()</span></div>
<div class="line"><a name="l00207"></a><span class="lineno"> 207</span>  <span class="comment">// << " running standalone:" << d->mRunningStandalone;</span></div>
<div class="line"><a name="l00208"></a><span class="lineno"> 208</span> </div>
<div class="line"><a name="l00209"></a><span class="lineno"> 209</span>  <span class="keywordflow">if</span> ( d->mRunningStandalone ) {</div>
<div class="line"><a name="l00210"></a><span class="lineno"> 210</span>  QObject::connect( QDBusConnection::sessionBus().interface(),</div>
<div class="line"><a name="l00211"></a><span class="lineno"> 211</span>  SIGNAL(serviceOwnerChanged(QString,QString,QString)),</div>
<div class="line"><a name="l00212"></a><span class="lineno"> 212</span>  <span class="keyword">this</span>, SLOT(slotApplicationRemoved(QString,QString,QString)) );</div>
<div class="line"><a name="l00213"></a><span class="lineno"> 213</span>  } <span class="keywordflow">else</span> {</div>
<div class="line"><a name="l00214"></a><span class="lineno"> 214</span>  d->mFactory->createHandler( d->mPlugin );</div>
<div class="line"><a name="l00215"></a><span class="lineno"> 215</span>  }</div>
<div class="line"><a name="l00216"></a><span class="lineno"> 216</span> }</div>
<div class="line"><a name="l00217"></a><span class="lineno"> 217</span> </div>
<div class="line"><a name="l00218"></a><span class="lineno"> 218</span> UniqueAppWatcher::~UniqueAppWatcher()</div>
<div class="line"><a name="l00219"></a><span class="lineno"> 219</span> {</div>
<div class="line"><a name="l00220"></a><span class="lineno"> 220</span>  <span class="keyword">delete</span> d->mFactory;</div>
<div class="line"><a name="l00221"></a><span class="lineno"> 221</span>  <span class="keyword">delete</span> d;</div>
<div class="line"><a name="l00222"></a><span class="lineno"> 222</span> }</div>
<div class="line"><a name="l00223"></a><span class="lineno"> 223</span> </div>
<div class="line"><a name="l00224"></a><span class="lineno"> 224</span> <span class="keywordtype">bool</span> UniqueAppWatcher::isRunningStandalone()<span class="keyword"> const</span></div>
<div class="line"><a name="l00225"></a><span class="lineno"> 225</span> <span class="keyword"></span>{</div>
<div class="line"><a name="l00226"></a><span class="lineno"> 226</span>  <span class="keywordflow">return</span> d->mRunningStandalone;</div>
<div class="line"><a name="l00227"></a><span class="lineno"> 227</span> }</div>
<div class="line"><a name="l00228"></a><span class="lineno"> 228</span> </div>
<div class="line"><a name="l00229"></a><span class="lineno"> 229</span> <span class="keywordtype">void</span> KontactInterface::UniqueAppWatcher::slotApplicationRemoved( <span class="keyword">const</span> QString &name,</div>
<div class="line"><a name="l00230"></a><span class="lineno"> 230</span>  <span class="keyword">const</span> QString &oldOwner,</div>
<div class="line"><a name="l00231"></a><span class="lineno"> 231</span>  <span class="keyword">const</span> QString &newOwner )</div>
<div class="line"><a name="l00232"></a><span class="lineno"> 232</span> {</div>
<div class="line"><a name="l00233"></a><span class="lineno"> 233</span>  <span class="keywordflow">if</span> ( oldOwner.isEmpty() || !newOwner.isEmpty() ) {</div>
<div class="line"><a name="l00234"></a><span class="lineno"> 234</span>  <span class="keywordflow">return</span>;</div>
<div class="line"><a name="l00235"></a><span class="lineno"> 235</span>  }</div>
<div class="line"><a name="l00236"></a><span class="lineno"> 236</span> </div>
<div class="line"><a name="l00237"></a><span class="lineno"> 237</span>  <span class="keyword">const</span> QString serviceName = <span class="stringliteral">"org.kde."</span> + d->mPlugin->objectName();</div>
<div class="line"><a name="l00238"></a><span class="lineno"> 238</span>  <span class="keywordflow">if</span> ( name == serviceName && d->mRunningStandalone ) {</div>
<div class="line"><a name="l00239"></a><span class="lineno"> 239</span>  d->mFactory->createHandler( d->mPlugin );</div>
<div class="line"><a name="l00240"></a><span class="lineno"> 240</span>  d->mRunningStandalone = <span class="keyword">false</span>;</div>
<div class="line"><a name="l00241"></a><span class="lineno"> 241</span>  }</div>
<div class="line"><a name="l00242"></a><span class="lineno"> 242</span> }</div>
<div class="line"><a name="l00243"></a><span class="lineno"> 243</span> </div>
<div class="line"><a name="l00244"></a><span class="lineno"><a class="code" href="classKontactInterface_1_1UniqueAppHandler.html#a6d5d90fb8840627756351e07d895e820"> 244</a></span> <span class="keywordtype">void</span> <a class="code" href="classKontactInterface_1_1UniqueAppHandler.html#a6d5d90fb8840627756351e07d895e820" title="Sets the main QWidget widget associated with this application.">KontactInterface::UniqueAppHandler::setMainWidget</a>( QWidget *widget )</div>
<div class="line"><a name="l00245"></a><span class="lineno"> 245</span> {</div>
<div class="line"><a name="l00246"></a><span class="lineno"> 246</span>  s_mainWidget = widget;</div>
<div class="line"><a name="l00247"></a><span class="lineno"> 247</span> }</div>
<div class="line"><a name="l00248"></a><span class="lineno"> 248</span> </div>
<div class="line"><a name="l00249"></a><span class="lineno"><a class="code" href="classKontactInterface_1_1UniqueAppHandler.html#a74f3f7424ca3fa0ecf30ddceabf539a4"> 249</a></span> QWidget *<a class="code" href="classKontactInterface_1_1UniqueAppHandler.html#a74f3f7424ca3fa0ecf30ddceabf539a4" title="Returns the main widget, which will zero if setMainWidget() has not be called yet.">KontactInterface::UniqueAppHandler::mainWidget</a>()</div>
<div class="line"><a name="l00250"></a><span class="lineno"> 250</span> {</div>
<div class="line"><a name="l00251"></a><span class="lineno"> 251</span>  <span class="keywordflow">return</span> s_mainWidget;</div>
<div class="line"><a name="l00252"></a><span class="lineno"> 252</span> }</div>
<div class="line"><a name="l00253"></a><span class="lineno"> 253</span> </div>
</div><!-- fragment --></div><!-- contents -->
<div class="copyrights">
This file is part of the KDE documentation.<br/>
Documentation copyright © 1996-2013 The KDE developers.<br/>
Generated on Fri Jul 12 2013 16:48:49 by
<a href="http://www.doxygen.org/index.html">doxygen</a> 1.8.3.1 written
by <a href="mailto:dimitri@stack.nl">Dimitri van Heesch</a>, © 1997-2006
<p>
KDE's <a href="http://techbase.kde.org/Policies/Library_Documentation_Policy">Doxygen guidelines</a> are available online.
</p>
</div>
</div>
</div>
</div>
<div id="left">
<div class="menu_box">
<a name="cp-menu" /><div class="menutitle"><div>
<h2 id="cp-menu-project">Kontact Plugin Interface Library</h2>
<a href="#cp-skip-project" class="cp-doNotDisplay">Skip menu "Kontact Plugin Interface Library"</a>
</div></div>
<ul><li><a href="index.html">Main Page</a></li><li><a href="classes.html">Alphabetical List</a></li><li><a href="annotated.html">Class List</a></li><li><a href="hierarchy.html">Class Hierarchy</a></li><li><a href="functions.html">Class Members</a></li><li><a href="files.html">File List</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="classKontactInterface_1_1Core.html">kontactinterface::core</option>, <option value="classKontactInterface_1_1PimUniqueApplication.html">kontactinterface::pimuniqueapplication</option>, <option value="classKontactInterface_1_1Plugin.html">kontactinterface::plugin</option>, <option value="classKontactInterface_1_1Summary.html">kontactinterface::summary</option>, <option value="classKontactInterface_1_1UniqueAppHandler.html">kontactinterface::uniqueapphandler</option>, <option value="classKontactInterface_1_1UniqueAppHandlerFactory.html">kontactinterface::uniqueapphandlerfactory</option>, <option value="classKontactInterface_1_1UniqueAppHandlerFactoryBase.html">kontactinterface::uniqueapphandlerfactorybase</option>, <option value="classKontactInterface_1_1UniqueAppWatcher.html">kontactinterface::uniqueappwatcher</option>,
</select>
</form>
</div>
-->
<div class="menu_box">
<a name="cp-menu" /><div class="menutitle"><div>
<h2 id="cp-menu-project">kdepimlibs-4.10.5 API Reference</h2>
<a href="#cp-skip-project" class="cp-doNotDisplay">Skip menu "kdepimlibs-4.10.5 API Reference"</a>
</div></div>
<div class="nav_list">
<ul>
<li><a href="../../akonadi/html/index.html">akonadi</a></li><li> <a href="../../akonadi/contact/html/index.html">contact</a></li><li> <a href="../../akonadi/kmime/html/index.html">kmime</a></li><li> <a href="../../akonadi/socialutils/html/index.html">socialutils</a></li><li><a href="../../kabc/html/index.html">kabc</a></li><li><a href="../../kalarmcal/html/index.html">kalarmcal</a></li><li><a href="../../kblog/html/index.html">kblog</a></li><li><a href="../../kcal/html/index.html">kcal</a></li><li><a href="../../kcalcore/html/index.html">kcalcore</a></li><li><a href="../../kcalutils/html/index.html">kcalutils</a></li><li><a href="../../kholidays/html/index.html">kholidays</a></li><li><a href="../../kimap/html/index.html">kimap</a></li><li><a href="../../kioslave/html/index.html">kioslave</a></li><li> <a href="../../kioslave/imap4/html/index.html">imap4</a></li><li> <a href="../../kioslave/mbox/html/index.html">mbox</a></li><li> <a href="../../kioslave/nntp/html/index.html">nntp</a></li><li><a href="../../kldap/html/index.html">kldap</a></li><li><a href="../../kmbox/html/index.html">kmbox</a></li><li><a href="../../kmime/html/index.html">kmime</a></li><li><a href="../../kontactinterface/html/index.html">kontactinterface</a></li><li><a href="../../kpimidentities/html/index.html">kpimidentities</a></li><li><a href="../../kpimtextedit/html/index.html">kpimtextedit</a></li><li><a href="../../kpimutils/html/index.html">kpimutils</a></li><li><a href="../../kresources/html/index.html">kresources</a></li><li><a href="../../ktnef/html/index.html">ktnef</a></li><li><a href="../../kxmlrpcclient/html/index.html">kxmlrpcclient</a></li><li><a href="../../mailtransport/html/index.html">mailtransport</a></li><li><a href="../../microblog/html/index.html">microblog</a></li><li><a href="../../qgpgme/html/index.html">qgpgme</a></li><li><a href="../../syndication/html/index.html">syndication</a></li><li> <a href="../../syndication/atom/html/index.html">atom</a></li><li> <a href="../../syndication/rdf/html/index.html">rdf</a></li><li> <a href="../../syndication/rss2/html/index.html">rss2</a></li>
</ul></div></div>
<!-- api_searchbox -->
</div>
</div>
<div class="clearer"></div>
</div>
<div class="clearer"></div>
</div>
<div id="end_body"></div>
<div id="footer"><div id="footer_text">
Report problems with this website to <a href="https://bugs.kde.org/enter_sysadmin_request.cgi?component=api.kde.org">our bug tracking system</a>.<br>
Contact the specific authors with questions and comments about the page contents.<p>
KDE<sup>®</sup> and <a href="/media/images/kde_gear_black.png">the K Desktop Environment<sup>®</sup> logo</a> are registered trademarks of <a href="http://ev.kde.org/" title="Homepage of the KDE non-profit Organization">KDE e.V.</a> |
<a href="http://www.kde.org/contact/impressum.php">Legal</a></p>
</div></div>
</div>
<!--
WARNING: DO NOT SEND MAIL TO THE FOLLOWING EMAIL ADDRESS! YOU WILL
BE BLOCKED INSTANTLY AND PERMANENTLY!
<a href="mailto:aaaatrap-45abe0e0c3bebc77@kde.org">Block me</a>
WARNING END
-->
</body>
</html>
