Web page and doxygen documentation created
[tpsession] / www / doxygen / classTpSession.html
diff --git a/www/doxygen/classTpSession.html b/www/doxygen/classTpSession.html
new file mode 100644 (file)
index 0000000..fa93e02
--- /dev/null
@@ -0,0 +1,395 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!DOCTYPE html
+    PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "DTD/xhtml1-strict.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+  <title>tpsession: TpSession Class Reference</title>
+  <link href="doxygen.css" rel="stylesheet" type="text/css" />
+</head>
+<body>
+<table border="0" cellpadding="0" cellspacing="0" width="100%">
+<tr>
+<td width="1">&nbsp;&nbsp;</td>
+<td class="postheader" valign="center">
+<a href="index.html">
+<font color="#004faf">Home</font></a>&nbsp;&middot;
+<a href="classes.html">
+<font color="#004faf">All Classes</font></a>&nbsp;&middot;
+<a href="namespaces.html">
+<font color="#004faf">All Namespaces</font></a>&nbsp;&middot;
+<a href="modules.html">
+<font color="#004faf">Modules</font></a>&nbsp;&middot;
+<a href="functions.html">
+<font color="#004faf">Functions</font></a>&nbsp;&middot;
+<a href="files.html">
+<font color="#004faf">Files</font></a>
+</td>
+</tr>
+</table>
+</body>
+</html>
+<!-- Generated by Doxygen 1.5.6 -->
+<div class="contents">
+<h1>TpSession Class Reference</h1><!-- doxytag: class="TpSession" --><code>#include &lt;<a class="el" href="tpsession_8h-source.html">tpsession.h</a>&gt;</code>
+<p>
+
+<p>
+<a href="classTpSession-members.html">List of all members.</a><h2>Signals</h2>
+<ul>
+<li>void <a class="el" href="classTpSession.html#d347e57e90a38ba88de384b0e12d29d9">amReady</a> (<a class="el" href="classTpSession.html">TpSession</a> *)
+<li>void <a class="el" href="classTpSession.html#73355b0eefdb9ddf9256cf5564a15384">accountReady</a> (<a class="el" href="classTpSessionAccount.html">TpSessionAccount</a> *)
+<li>void <a class="el" href="classTpSession.html#c748175fc27394bebad29dca135ae9b4">channeReady</a> (<a class="el" href="classTpSessionAccount.html">TpSessionAccount</a> *)
+<li>void <a class="el" href="classTpSession.html#4140850eed688948df8e86b760ca3ffd">messageReceived</a> (const Tp::ReceivedMessage &amp;, <a class="el" href="classTpSessionAccount.html">TpSessionAccount</a> *)
+</ul>
+<h2>Public Member Functions</h2>
+<ul>
+<li><a class="el" href="classTpSession.html#044a254379e9c218db0a94923b6541e2">TpSession</a> (QString cmname=QString(), bool synchronous=FALSE)
+<li>void <a class="el" href="classTpSession.html#d4631fd1a7c35a4b964df6e7ba9286b5">sendMessageToAddress</a> (QString connectionMgr, QString address, QString message)
+<li><a class="el" href="classTpSessionAccount.html">TpSessionAccount</a> * <a class="el" href="classTpSession.html#eb1e40ae48a4b3e833a62c08a0a843b1">getAccount</a> (const QString cm, const QString protocol=QString())
+<li>void <a class="el" href="classTpSession.html#6128c07874af5745ce5313b01c7ab5a8">createChannelListener</a> (const QString &amp;channelType, const Tp::MethodInvocationContextPtr&lt;&gt; &amp;context, const Tp::AccountPtr &amp;account, const Tp::ChannelPtr &amp;channel)
+<li>void <a class="el" href="classTpSession.html#4aceacc0eb867cd8624ae647a571fdf6">createObserver</a> ()
+</ul>
+<h2>Static Public Member Functions</h2>
+<ul>
+<li>static <a class="el" href="classTpSession.html">TpSession</a> * <a class="el" href="classTpSession.html#a3cb4db71a56f67e75d80a087e8c4805">instance</a> (bool synchronous=TRUE)
+</ul>
+<h2>Public Attributes</h2>
+<ul>
+<li>QVector&lt; <a class="el" href="classTpSessionAccount.html">TpSessionAccount</a> * &gt; <a class="el" href="classTpSession.html#f592fe9efb0b7072dc5166a83f11c56c">accounts</a>
+</ul>
+<hr><a name="_details"></a><h2>Detailed Description</h2>
+Top level class, counterpart of Account Manager. <a class="el" href="classTpSession.html">TpSession</a> connects to account manager and requests accounts from it. <a class="el" href="classTpSession.html">TpSession</a> creates <a class="el" href="classTpSessionAccount.html">TpSessionAccount</a> for all accounts . As top level class <a class="el" href="classTpSession.html">TpSession</a> provides simÃ¥lified interface to send and receive messages via any account. <a class="el" href="classTpSession.html">TpSession</a> provides signal when it has accounts ready. If you require some specific account in constructor, you will receive signal only when this account is ready. If you use constructor without any parameters, you will get one signal for every account. If synchronous is true, constructor is executed as synchronous and it does return after transactions to set up accounts are done. <hr><h2>Constructor &amp; Destructor Documentation</h2>
+<a class="anchor" name="044a254379e9c218db0a94923b6541e2"></a><!-- doxytag: member="TpSession::TpSession" ref="044a254379e9c218db0a94923b6541e2" args="(QString cmname=QString(), bool synchronous=FALSE)" -->
+<div class="memitem">
+<div class="memproto">
+      <table class="memname">
+        <tr>
+          <td class="memname"><a class="el" href="classTpSession.html">TpSession</a>           </td>
+          <td>(</td>
+          <td class="paramtype">QString&nbsp;</td>
+          <td class="paramname"> <em>cmname</em> = <code>QString()</code>, </td>
+        </tr>
+        <tr>
+          <td class="paramkey"></td>
+          <td></td>
+          <td class="paramtype">bool&nbsp;</td>
+          <td class="paramname"> <em>synchronous</em> = <code>FALSE</code></td><td>&nbsp;</td>
+        </tr>
+        <tr>
+          <td></td>
+          <td>)</td>
+          <td></td><td></td><td></td>
+        </tr>
+      </table>
+</div>
+<div class="memdoc">
+
+<p>
+Construct a new <a class="el" href="classTpSession.html">TpSession</a> object.<p>
+<dl compact><dt><b>Parameters:</b></dt><dd>
+  <table border="0" cellspacing="2" cellpadding="0">
+    <tr><td valign="top"></td><td valign="top"><em>cmname</em>&nbsp;</td><td>Name of the default connection manager. Can be empty or omnitted, then there is no default connection manager </td></tr>
+    <tr><td valign="top"></td><td valign="top"><em>synchronous</em>&nbsp;</td><td>if false, asynchronous behavior, function returns immediately and accountReady signals are emitted when accounts are ready if True, synchronous behavior and function returns when accounts are ready </td></tr>
+  </table>
+</dl>
+
+</div>
+</div><p>
+<hr><h2>Member Function Documentation</h2>
+<a class="anchor" name="a3cb4db71a56f67e75d80a087e8c4805"></a><!-- doxytag: member="TpSession::instance" ref="a3cb4db71a56f67e75d80a087e8c4805" args="(bool synchronous=TRUE)" -->
+<div class="memitem">
+<div class="memproto">
+      <table class="memname">
+        <tr>
+          <td class="memname"><a class="el" href="classTpSession.html">TpSession</a> * instance           </td>
+          <td>(</td>
+          <td class="paramtype">bool&nbsp;</td>
+          <td class="paramname"> <em>synchronous</em> = <code>TRUE</code>          </td>
+          <td>&nbsp;)&nbsp;</td>
+          <td><code> [static]</code></td>
+        </tr>
+      </table>
+</div>
+<div class="memdoc">
+
+<p>
+Returns pointer to <a class="el" href="classTpSession.html">TpSession</a> singleton. If there is not yet <a class="el" href="classTpSession.html">TpSession</a> Object, creates it with "Ring" connection manager as default<p>
+<dl compact><dt><b>Parameters:</b></dt><dd>
+  <table border="0" cellspacing="2" cellpadding="0">
+    <tr><td valign="top"></td><td valign="top"><em>synchronous</em>&nbsp;</td><td>if false, asynchronous behavior, function returns immediately and accountReady signals are emitted when accounts are ready if True, synchronous behavior and function returns when accounts are ready </td></tr>
+  </table>
+</dl>
+
+</div>
+</div><p>
+<a class="anchor" name="d4631fd1a7c35a4b964df6e7ba9286b5"></a><!-- doxytag: member="TpSession::sendMessageToAddress" ref="d4631fd1a7c35a4b964df6e7ba9286b5" args="(QString connectionMgr, QString address, QString message)" -->
+<div class="memitem">
+<div class="memproto">
+      <table class="memname">
+        <tr>
+          <td class="memname">void sendMessageToAddress           </td>
+          <td>(</td>
+          <td class="paramtype">QString&nbsp;</td>
+          <td class="paramname"> <em>connectionMgr</em>, </td>
+        </tr>
+        <tr>
+          <td class="paramkey"></td>
+          <td></td>
+          <td class="paramtype">QString&nbsp;</td>
+          <td class="paramname"> <em>address</em>, </td>
+        </tr>
+        <tr>
+          <td class="paramkey"></td>
+          <td></td>
+          <td class="paramtype">QString&nbsp;</td>
+          <td class="paramname"> <em>message</em></td><td>&nbsp;</td>
+        </tr>
+        <tr>
+          <td></td>
+          <td>)</td>
+          <td></td><td></td><td></td>
+        </tr>
+      </table>
+</div>
+<div class="memdoc">
+
+<p>
+Send message using specified connection manager to address<p>
+<dl compact><dt><b>Parameters:</b></dt><dd>
+  <table border="0" cellspacing="2" cellpadding="0">
+    <tr><td valign="top"></td><td valign="top"><em>connectionMgr</em>&nbsp;</td><td>Name of the connection manager </td></tr>
+    <tr><td valign="top"></td><td valign="top"><em>address</em>&nbsp;</td><td>Valid address for this connection manager type. Asexample telephone number to Ring, GoogleTalk address for Gabble </td></tr>
+    <tr><td valign="top"></td><td valign="top"><em>message</em>&nbsp;</td><td>Message body </td></tr>
+  </table>
+</dl>
+
+</div>
+</div><p>
+<a class="anchor" name="eb1e40ae48a4b3e833a62c08a0a843b1"></a><!-- doxytag: member="TpSession::getAccount" ref="eb1e40ae48a4b3e833a62c08a0a843b1" args="(const QString cm, const QString protocol=QString())" -->
+<div class="memitem">
+<div class="memproto">
+      <table class="memname">
+        <tr>
+          <td class="memname"><a class="el" href="classTpSessionAccount.html">TpSessionAccount</a> * getAccount           </td>
+          <td>(</td>
+          <td class="paramtype">const QString&nbsp;</td>
+          <td class="paramname"> <em>cm</em>, </td>
+        </tr>
+        <tr>
+          <td class="paramkey"></td>
+          <td></td>
+          <td class="paramtype">const QString&nbsp;</td>
+          <td class="paramname"> <em>protocol</em> = <code>QString()</code></td><td>&nbsp;</td>
+        </tr>
+        <tr>
+          <td></td>
+          <td>)</td>
+          <td></td><td></td><td></td>
+        </tr>
+      </table>
+</div>
+<div class="memdoc">
+
+<p>
+Returns pointer to TpSessionAccout object with specified connection manager or protocol, returns NULL if no match found<p>
+<dl compact><dt><b>Parameters:</b></dt><dd>
+  <table border="0" cellspacing="2" cellpadding="0">
+    <tr><td valign="top"></td><td valign="top"><em>cm</em>&nbsp;</td><td>Name of the connection manager, if left empty matches every entry </td></tr>
+    <tr><td valign="top"></td><td valign="top"><em>protocol</em>&nbsp;</td><td>Name of the protocol manager, if left empty matches every entry </td></tr>
+  </table>
+</dl>
+
+</div>
+</div><p>
+<a class="anchor" name="6128c07874af5745ce5313b01c7ab5a8"></a><!-- doxytag: member="TpSession::createChannelListener" ref="6128c07874af5745ce5313b01c7ab5a8" args="(const QString &amp;channelType, const Tp::MethodInvocationContextPtr&lt;&gt; &amp;context, const Tp::AccountPtr &amp;account, const Tp::ChannelPtr &amp;channel)" -->
+<div class="memitem">
+<div class="memproto">
+      <table class="memname">
+        <tr>
+          <td class="memname">void createChannelListener           </td>
+          <td>(</td>
+          <td class="paramtype">const QString &amp;&nbsp;</td>
+          <td class="paramname"> <em>channelType</em>, </td>
+        </tr>
+        <tr>
+          <td class="paramkey"></td>
+          <td></td>
+          <td class="paramtype">const Tp::MethodInvocationContextPtr&lt;&gt; &amp;&nbsp;</td>
+          <td class="paramname"> <em>context</em>, </td>
+        </tr>
+        <tr>
+          <td class="paramkey"></td>
+          <td></td>
+          <td class="paramtype">const Tp::AccountPtr &amp;&nbsp;</td>
+          <td class="paramname"> <em>account</em>, </td>
+        </tr>
+        <tr>
+          <td class="paramkey"></td>
+          <td></td>
+          <td class="paramtype">const Tp::ChannelPtr &amp;&nbsp;</td>
+          <td class="paramname"> <em>channel</em></td><td>&nbsp;</td>
+        </tr>
+        <tr>
+          <td></td>
+          <td>)</td>
+          <td></td><td></td><td></td>
+        </tr>
+      </table>
+</div>
+<div class="memdoc">
+
+<p>
+
+</div>
+</div><p>
+<a class="anchor" name="4aceacc0eb867cd8624ae647a571fdf6"></a><!-- doxytag: member="TpSession::createObserver" ref="4aceacc0eb867cd8624ae647a571fdf6" args="()" -->
+<div class="memitem">
+<div class="memproto">
+      <table class="memname">
+        <tr>
+          <td class="memname">void createObserver           </td>
+          <td>(</td>
+          <td class="paramname">          </td>
+          <td>&nbsp;)&nbsp;</td>
+          <td></td>
+        </tr>
+      </table>
+</div>
+<div class="memdoc">
+
+<p>
+
+</div>
+</div><p>
+<a class="anchor" name="d347e57e90a38ba88de384b0e12d29d9"></a><!-- doxytag: member="TpSession::amReady" ref="d347e57e90a38ba88de384b0e12d29d9" args="(TpSession *)" -->
+<div class="memitem">
+<div class="memproto">
+      <table class="memname">
+        <tr>
+          <td class="memname">void amReady           </td>
+          <td>(</td>
+          <td class="paramtype"><a class="el" href="classTpSession.html">TpSession</a> *&nbsp;</td>
+          <td class="paramname"> <em>_t1</em>          </td>
+          <td>&nbsp;)&nbsp;</td>
+          <td><code> [signal]</code></td>
+        </tr>
+      </table>
+</div>
+<div class="memdoc">
+
+<p>
+Emitted when the account Manager becomes ready<p>
+<dl compact><dt><b>Parameters:</b></dt><dd>
+  <table border="0" cellspacing="2" cellpadding="0">
+    <tr><td valign="top"></td><td valign="top"><em><a class="el" href="classTpSession.html">TpSession</a></em>&nbsp;</td><td>pointer to <a class="el" href="classTpSession.html">TpSession</a> class </td></tr>
+  </table>
+</dl>
+
+</div>
+</div><p>
+<a class="anchor" name="73355b0eefdb9ddf9256cf5564a15384"></a><!-- doxytag: member="TpSession::accountReady" ref="73355b0eefdb9ddf9256cf5564a15384" args="(TpSessionAccount *)" -->
+<div class="memitem">
+<div class="memproto">
+      <table class="memname">
+        <tr>
+          <td class="memname">void accountReady           </td>
+          <td>(</td>
+          <td class="paramtype"><a class="el" href="classTpSessionAccount.html">TpSessionAccount</a> *&nbsp;</td>
+          <td class="paramname"> <em>_t1</em>          </td>
+          <td>&nbsp;)&nbsp;</td>
+          <td><code> [signal]</code></td>
+        </tr>
+      </table>
+</div>
+<div class="memdoc">
+
+<p>
+Emitted when the account becomes ready<p>
+<dl compact><dt><b>Parameters:</b></dt><dd>
+  <table border="0" cellspacing="2" cellpadding="0">
+    <tr><td valign="top"></td><td valign="top"><em><a class="el" href="classTpSessionAccount.html">TpSessionAccount</a></em>&nbsp;</td><td>pointer to account become ready </td></tr>
+  </table>
+</dl>
+
+</div>
+</div><p>
+<a class="anchor" name="c748175fc27394bebad29dca135ae9b4"></a><!-- doxytag: member="TpSession::channeReady" ref="c748175fc27394bebad29dca135ae9b4" args="(TpSessionAccount *)" -->
+<div class="memitem">
+<div class="memproto">
+      <table class="memname">
+        <tr>
+          <td class="memname">void channeReady           </td>
+          <td>(</td>
+          <td class="paramtype"><a class="el" href="classTpSessionAccount.html">TpSessionAccount</a> *&nbsp;</td>
+          <td class="paramname"> <em>_t1</em>          </td>
+          <td>&nbsp;)&nbsp;</td>
+          <td><code> [signal]</code></td>
+        </tr>
+      </table>
+</div>
+<div class="memdoc">
+
+<p>
+
+</div>
+</div><p>
+<a class="anchor" name="4140850eed688948df8e86b760ca3ffd"></a><!-- doxytag: member="TpSession::messageReceived" ref="4140850eed688948df8e86b760ca3ffd" args="(const Tp::ReceivedMessage &amp;, TpSessionAccount *)" -->
+<div class="memitem">
+<div class="memproto">
+      <table class="memname">
+        <tr>
+          <td class="memname">void messageReceived           </td>
+          <td>(</td>
+          <td class="paramtype">const Tp::ReceivedMessage &amp;&nbsp;</td>
+          <td class="paramname"> <em>_t1</em>, </td>
+        </tr>
+        <tr>
+          <td class="paramkey"></td>
+          <td></td>
+          <td class="paramtype"><a class="el" href="classTpSessionAccount.html">TpSessionAccount</a> *&nbsp;</td>
+          <td class="paramname"> <em>_t2</em></td><td>&nbsp;</td>
+        </tr>
+        <tr>
+          <td></td>
+          <td>)</td>
+          <td></td><td></td><td><code> [signal]</code></td>
+        </tr>
+      </table>
+</div>
+<div class="memdoc">
+
+<p>
+Emitted when any of Account Managers recived message<p>
+<dl compact><dt><b>Parameters:</b></dt><dd>
+  <table border="0" cellspacing="2" cellpadding="0">
+    <tr><td valign="top"></td><td valign="top"><em>Tp::ReceivedMessage</em>&nbsp;</td><td>Message received </td></tr>
+    <tr><td valign="top"></td><td valign="top"><em><a class="el" href="classTpSessionAccount.html">TpSessionAccount</a></em>&nbsp;</td><td>pointer to account received message </td></tr>
+  </table>
+</dl>
+
+</div>
+</div><p>
+<hr><h2>Member Data Documentation</h2>
+<a class="anchor" name="f592fe9efb0b7072dc5166a83f11c56c"></a><!-- doxytag: member="TpSession::accounts" ref="f592fe9efb0b7072dc5166a83f11c56c" args="" -->
+<div class="memitem">
+<div class="memproto">
+      <table class="memname">
+        <tr>
+          <td class="memname">QVector&lt;<a class="el" href="classTpSessionAccount.html">TpSessionAccount</a>*&gt; <a class="el" href="classTpSession.html#f592fe9efb0b7072dc5166a83f11c56c">accounts</a>          </td>
+        </tr>
+      </table>
+</div>
+<div class="memdoc">
+
+<p>
+
+</div>
+</div><p>
+</div>
+<p /><address><hr /><div align="center">
+<table width="100%" cellspacing="0" border="0"><tr class="address">
+<td width="30%">Copyright &copy; 2010 Nokia Corporation</td>
+<td width="30%" align="right"><div align="right">TpSession </div></td>
+</tr></table></div></address>
+</body>
+</html>