<?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>interfaces: KIMIface Class Reference (interfaces)</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=".">interfaces</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>
<div class="header">
<div class="summary">
<a href="#pub-attribs">Public Attributes</a> </div>
<div class="headertitle">
<div class="title">KIMIface Class Reference</div> </div>
</div>
<div class="contents">
<!-- doxytag: class="KIMIface" --><!-- doxytag: inherits="DCOPObject" -->
<p>Generic DCOP interface for <a class="elRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/namespaceKDE.html">KDE</a> instant messenger applications.
<a href="classKIMIface.html#details">More...</a></p>
<p><code>#include <<a class="el" href="kimiface_8h_source.html">kimiface.h</a>></code></p>
<div class="dynheader">
Inheritance diagram for KIMIface:</div>
<div class="dyncontent">
<div class="center">
<img src="classKIMIface.png" usemap="#KIMIface_map" alt=""/>
<map id="KIMIface_map" name="KIMIface_map">
<area doxygen="dcop.tag:../../dcop/html/" href="../../dcop/html/classDCOPObject.html" alt="DCOPObject" shape="rect" coords="0,0,85,24"/>
</map>
</div></div>
<p><a href="classKIMIface-members.html">List of all members.</a></p>
<table class="memberdecls">
<tr><td colspan="2"><h2><a name="pub-attribs"></a>
Public Attributes</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a8e0dc652e36f42d4e2f2874d4729a226"></a><!-- doxytag: member="KIMIface::__pad0__" ref="a8e0dc652e36f42d4e2f2874d4729a226" args="" -->
k_dcop_signals </td><td class="memItemRight" valign="bottom"><b>__pad0__</b>: void contactPresenceChanged( <a class="elRef" href="qstring.html">QString</a> uid</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a3d903d6289c99094df12c0ee4c88e3e1"></a><!-- doxytag: member="KIMIface::appId" ref="a3d903d6289c99094df12c0ee4c88e3e1" args="" -->
k_dcop_signals <a class="elRef" href="qcstring.html">QCString</a> </td><td class="memItemRight" valign="bottom"><b>appId</b></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a022929ae1fe830fd33596139d56d58d0"></a><!-- doxytag: member="KIMIface::presence" ref="a022929ae1fe830fd33596139d56d58d0" args="" -->
k_dcop_signals <a class="elRef" href="qcstring.html">QCString</a> int </td><td class="memItemRight" valign="bottom"><b>presence</b></td></tr>
</table>
<hr/><a name="details" id="details"></a><h2>Detailed Description</h2>
<div class="textblock"><p>Generic DCOP interface for <a class="elRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/namespaceKDE.html">KDE</a> instant messenger applications. </p>
<p>The interface has two parts:</p>
<ul>
<li>methods to get information about IM-contacts, such as their reachability or their presence status (if the are online or away, etc)</li>
<li>methods to initiate communication with IM-contacts, e.g. sending messages</li>
</ul>
<dl class="note"><dt><b>Note:</b></dt><dd>If you are looking for a information about accessing application's that implement this interface, have a look at the <a class="el" href="classKIMProxy.html" title="Provides access to instant messenger programs which implement KDE's instant messanger interface KIMIf...">KIMProxy</a> class.</dd></dl>
<p>Contacts are identified using unique identifier strings (UID) used by KABC, the <a class="elRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/namespaceKDE.html">KDE</a> address book library. The UID generation is handled by KABC::Addressee so the your application will either have to access the address book or provide a possibility for associating a contact of your application with an entry of the address book.</p>
<dl class="note"><dt><b>Note:</b></dt><dd>one omission of this interface is the lack of control over the range of values used for protocols' names.</dd></dl>
<p>If you are implementing this interface, note that your application must have the following information in its desktop file, so that it can be identified as providing <a class="el" href="classKIMIface.html" title="Generic DCOP interface for KDE instant messenger applications.">KIMIface</a> at runtime: </p>
<div class="fragment"><pre class="fragment"> X-DCOP-ServiceName=<application-<a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/namespaceKStdAccel.html#a737bc2466b1f000625fe8ebddffbb09d">name</a>>
ServiceTypes=DCOP/InstantMessenger
</pre></div><p> and the class implementing <a class="el" href="classKIMIface.html" title="Generic DCOP interface for KDE instant messenger applications.">KIMIface</a> must pass "KIMIface" to the <a class="elRef" doxygen="dcop.tag:../../dcop/html/" href="../../dcop/html/classDCOPObject.html">DCOPObject</a> constructor: </p>
<div class="fragment"><pre class="fragment"> <span class="comment">// just need QObject inheritance and Q_OBJECT if you want signals and slots</span>
<span class="comment">// no need to use K_DCOP macro again</span>
<span class="keyword">class </span>MyIMIface : <span class="keyword">public</span> <a class="codeRef" href="qobject.html">QObject</a>, <span class="keyword">public</span> <a class="code" href="classKIMIface.html" title="Generic DCOP interface for KDE instant messenger applications.">KIMIface</a>
{
Q_OBJECT
<span class="keyword">public</span>:
MyIMIface(<a class="codeRef" href="qobject.html">QObject</a>* parent = 0, <span class="keyword">const</span> <span class="keywordtype">char</span>* name) :
<a class="codeRef" doxygen="dcop.tag:../../dcop/html/" href="../../dcop/html/classDCOPObject.html">DCOPObject</a>(<span class="stringliteral">"KIMIface"</span>), <span class="comment">// <-- passing the interface name as required</span>
<a class="codeRef" href="qobject.html">QObject</a>(parent, name) {}
};
</pre></div><p>The DCOP part of the interface needs to be processed by the DCOP IDL compiler. The <a class="elRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/namespaceKDE.html">KDE</a> autotools framework will do this automatically, all you have to do is add kimiface.skel and kimiface.stub to the <code>SOURCES</code> list in your <code>Makefile.am</code> </p>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="classKIMProxy.html" title="Provides access to instant messenger programs which implement KDE's instant messanger interface KIMIf...">KIMProxy</a> </dd>
<dd>
KABC::AddressBook </dd>
<dd>
KABC::Addressee</dd></dl>
<dl class="since"><dt><b>Since:</b></dt><dd>3.3 </dd></dl>
<dl class="author"><dt><b>Author:</b></dt><dd>Will Stephenson <<a href="mailto:lists@stevello.free-online.co.uk">lists@stevello.free-online.co.uk</a>> </dd></dl>
<p>Definition at line <a class="el" href="kimiface_8h_source.html#l00085">85</a> of file <a class="el" href="kimiface_8h_source.html">kimiface.h</a>.</p>
</div><hr/><h2>Member Function Documentation</h2>
<a class="anchor" id="ab0e1a3c192e4c0ddc2c39d00b68fbc26"></a><!-- doxytag: member="KIMIface::addContact" ref="ab0e1a3c192e4c0ddc2c39d00b68fbc26" args="(const QString &contactId, const QString &protocol)=0" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual bool KIMIface::addContact </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> & </td>
<td class="paramname"><em>contactId</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> & </td>
<td class="paramname"><em>protocol</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td><code> [pure virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Add a new contact given its protocol specific identifier. </p>
<p>Implementations might add the contact silently, including sending an authorization request if necessary, ask the user for confirmation or just prefill the usual contact addingGUI.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">contactId</td><td>the protocol specific identifier for the contact e.g. UIN for ICQ, screenname for AIM, nick for IRC </td></tr>
<tr><td class="paramname">protocol</td><td>the IM protocol/service to use. See <a class="el" href="classKIMIface.html#a8cd2b852952e0d2072bafff36ef928c4" title="Obtain a list of supported IM services/protocols.">protocols()</a> </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>whether the add succeeded. <code>false</code> may signal already present, protocol not supported, or add operation not supported.</dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="classKIMIface.html#ad7d53da7ae9a4208633a6488f2ea1ac5" title="Obtain the KABC UID corresponding to the given IM address.">locate()</a> </dd>
<dd>
<a class="el" href="classKIMIface.html#a8cd2b852952e0d2072bafff36ef928c4" title="Obtain a list of supported IM services/protocols.">protocols()</a> </dd>
<dd>
<a class="el" href="classKIMIface.html#af76a5092a737fd26aef8be599ffebda6" title="Send a single message to a contact given only its protocol specific identifier.">messageNewContact()</a> </dd></dl>
</div>
</div>
<a class="anchor" id="a6dec061f109a7929b95b29ae6beade55"></a><!-- doxytag: member="KIMIface::allContacts" ref="a6dec061f109a7929b95b29ae6beade55" args="()=0" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual <a class="elRef" href="qstringlist.html">QStringList</a> KIMIface::allContacts </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td><code> [pure virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Obtain a list of IM-contacts that are known to the application. </p>
<p>Return a list of KABC UIDs of all the contacts you have such IDs for.</p>
<dl class="return"><dt><b>Returns:</b></dt><dd>a list of KABC UIDs known to the application</dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="classKIMIface.html#a1f3c8cce3e1ab97cb2a0775f46f78592" title="Obtain a list of IM-contacts that are currently reachable.">reachableContacts()</a> </dd>
<dd>
<a class="el" href="classKIMIface.html#a098efa69d4e27164b8092cfa021e031e" title="Obtain a list of IM-contacts that are currently online.">onlineContacts()</a> </dd>
<dd>
<a class="el" href="classKIMIface.html#a195de9417f76fa8d88302405de9284a1" title="Obtain a list of IM-contacts who may receive file transfers.">fileTransferContacts()</a> </dd>
<dd>
<a class="el" href="classKIMIface.html#a8aa014d82e6cdae7e74a371f25063283" title="Confirm if a given contact is known to the IM application.">isPresent()</a> </dd>
<dd>
KABC::Addressee::uid() </dd></dl>
</div>
</div>
<a class="anchor" id="ace9e8ccd05eca2a415be880c9a335900"></a><!-- doxytag: member="KIMIface::canReceiveFiles" ref="ace9e8ccd05eca2a415be880c9a335900" args="(const QString &uid)=0" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual bool KIMIface::canReceiveFiles </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> & </td>
<td class="paramname"><em>uid</em></td><td>)</td>
<td><code> [pure virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Indicate if a given contact can receive files. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">uid</td><td>the KABC UID you want to the file transfer capability for </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>whether the specified contact can receive files</dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="classKIMIface.html#a195de9417f76fa8d88302405de9284a1" title="Obtain a list of IM-contacts who may receive file transfers.">fileTransferContacts()</a> </dd>
<dd>
KABC::Addressee::uid() </dd></dl>
</div>
</div>
<a class="anchor" id="a992d46ec4844acbce274775070d35069"></a><!-- doxytag: member="KIMIface::canRespond" ref="a992d46ec4844acbce274775070d35069" args="(const QString &uid)=0" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual bool KIMIface::canRespond </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> & </td>
<td class="paramname"><em>uid</em></td><td>)</td>
<td><code> [pure virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Indicate if a given contact will be able to respond. </p>
<p>Some media are unidirectional (e.g., sending SMS via a web interface). This refers to the contact's ability to respond as defined by the medium, not by their presence.</p>
<p>Someone may appear offline (SMS has no presence) to you but in fact be able to respond.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">uid</td><td>the KABC UID you are interested in </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>whether the specified contact can respond</dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="classKIMIface.html#a8aa014d82e6cdae7e74a371f25063283" title="Confirm if a given contact is known to the IM application.">isPresent()</a> </dd>
<dd>
KABC::Addressee::uid() </dd></dl>
</div>
</div>
<a class="anchor" id="a56e9a33392f0cdb09ba632d839d615f4"></a><!-- doxytag: member="KIMIface::chatWithContact" ref="a56e9a33392f0cdb09ba632d839d615f4" args="(const QString &uid)=0" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual void KIMIface::chatWithContact </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> & </td>
<td class="paramname"><em>uid</em></td><td>)</td>
<td><code> [pure virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Start a chat session with the specified contact. </p>
<p>Applications that do not support a chat mode or when the IM-service of the given contact does not support it, this can also open a normal message input GUI.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">uid</td><td>the KABC UID you want to chat with</td></tr>
</table>
</dd>
</dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="classKIMIface.html#afa35037e419a99d19eecae6eb49cb076" title="Send a single message to the specified contact.">messageContact()</a> </dd>
<dd>
<a class="el" href="classKIMIface.html#af76a5092a737fd26aef8be599ffebda6" title="Send a single message to a contact given only its protocol specific identifier.">messageNewContact()</a> </dd>
<dd>
<a class="el" href="classKIMIface.html#a1aa51b4d57343ebcb6cf2c4f9fcd62f8" title="Send a file to the contact.">sendFile()</a> </dd>
<dd>
<a class="el" href="classKIMIface.html#a8aa014d82e6cdae7e74a371f25063283" title="Confirm if a given contact is known to the IM application.">isPresent()</a> </dd>
<dd>
<a class="el" href="classKIMIface.html#a1f3c8cce3e1ab97cb2a0775f46f78592" title="Obtain a list of IM-contacts that are currently reachable.">reachableContacts()</a> </dd>
<dd>
KABC::Addressee::uid() </dd></dl>
</div>
</div>
<a class="anchor" id="a01c7b11eefd3d3bc4ad355b335a24d15"></a><!-- doxytag: member="KIMIface::context" ref="a01c7b11eefd3d3bc4ad355b335a24d15" args="(const QString &uid)=0" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual <a class="elRef" href="qstring.html">QString</a> KIMIface::context </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> & </td>
<td class="paramname"><em>uid</em></td><td>)</td>
<td><code> [pure virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Obtain the given contact's current context (home, work, or any) </p>
<p>Not all IM services/protocols support the concept of contexts. If the given UID maps to such a service, just return <code>QString::null</code> </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">uid</td><td>the KABC UID you want the context for </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>a string describing the context, or <code>QString::null</code> if not supported or if the contact is unknown</dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="classKIMIface.html#a8aa014d82e6cdae7e74a371f25063283" title="Confirm if a given contact is known to the IM application.">isPresent()</a> </dd>
<dd>
KABC::Addressee::uid() </dd></dl>
</div>
</div>
<a class="anchor" id="aac6f0ba963b2a7a1a22aec7bd20e38fc"></a><!-- doxytag: member="KIMIface::displayName" ref="aac6f0ba963b2a7a1a22aec7bd20e38fc" args="(const QString &uid)=0" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual <a class="elRef" href="qstring.html">QString</a> KIMIface::displayName </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> & </td>
<td class="paramname"><em>uid</em></td><td>)</td>
<td><code> [pure virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Obtain the IM app's idea of the contact's display name. </p>
<p>Useful if KABC lookups may be too slow. Should return whatever the application uses in its contact list or similar GUI, e.g. a nick name, a user configured name string, etc.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">uid</td><td>the KABC UID you are interested in </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>the corresponding display name or <a class="elRef" href="qstring.html">QString</a>:null if the UID is unknown</dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="classKIMIface.html#a8aa014d82e6cdae7e74a371f25063283" title="Confirm if a given contact is known to the IM application.">isPresent()</a> </dd>
<dd>
<a class="el" href="classKIMIface.html#aa7f8d0c01f12ab13b8faee681d5cc1f3" title="Obtain the IM presence as a i18ned string for the specified contact.">presenceString()</a> </dd>
<dd>
<a class="el" href="classKIMIface.html#a0100d77fb96b40ba5b47ff0eef989178" title="Obtain the IM presence as a number for the specified contact.">presenceStatus()</a> </dd>
<dd>
KABC::Addressee::uid() </dd></dl>
</div>
</div>
<a class="anchor" id="a195de9417f76fa8d88302405de9284a1"></a><!-- doxytag: member="KIMIface::fileTransferContacts" ref="a195de9417f76fa8d88302405de9284a1" args="()=0" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual <a class="elRef" href="qstringlist.html">QStringList</a> KIMIface::fileTransferContacts </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td><code> [pure virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Obtain a list of IM-contacts who may receive file transfers. </p>
<p>Return a list of KABC UIDs of the contacts that are capable of receiving file transfers based on the IM-service they are associated with, i.e. if it is technically able to provide this, on their online state, i.e. can likely not receive files while offline, and perhaps even information your application has additionally, e.g. a user config that tells you that the contact is behind a firewall.</p>
<p>The simplest implementation is to return the same list as <a class="el" href="classKIMIface.html#a098efa69d4e27164b8092cfa021e031e" title="Obtain a list of IM-contacts that are currently online.">onlineContacts()</a>, provided all the IM-services that are currently used support it.</p>
<dl class="return"><dt><b>Returns:</b></dt><dd>a list of KABC UIDs capable of file transfer</dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="classKIMIface.html#a6dec061f109a7929b95b29ae6beade55" title="Obtain a list of IM-contacts that are known to the application.">allContacts()</a> </dd>
<dd>
<a class="el" href="classKIMIface.html#a1f3c8cce3e1ab97cb2a0775f46f78592" title="Obtain a list of IM-contacts that are currently reachable.">reachableContacts()</a> </dd>
<dd>
<a class="el" href="classKIMIface.html#a098efa69d4e27164b8092cfa021e031e" title="Obtain a list of IM-contacts that are currently online.">onlineContacts()</a> </dd>
<dd>
<a class="el" href="classKIMIface.html#ace9e8ccd05eca2a415be880c9a335900" title="Indicate if a given contact can receive files.">canReceiveFiles()</a> </dd>
<dd>
<a class="el" href="classKIMIface.html#a1aa51b4d57343ebcb6cf2c4f9fcd62f8" title="Send a file to the contact.">sendFile()</a> </dd>
<dd>
KABC::Addressee::uid() </dd></dl>
</div>
</div>
<a class="anchor" id="a0f0cc5a23277d9becd57ffef6cf10e97"></a><!-- doxytag: member="KIMIface::icon" ref="a0f0cc5a23277d9becd57ffef6cf10e97" args="(const QString &uid)=0" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual <a class="elRef" href="qpixmap.html">QPixmap</a> KIMIface::icon </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> & </td>
<td class="paramname"><em>uid</em></td><td>)</td>
<td><code> [pure virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Obtain the icon representing the IM presence for the specified contact. </p>
<p>Return the image the application would use to display a contact's presence. The size and other properties of the image are currently unspecified.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">uid</td><td>the KABC UID you want the presence icon for </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>a pixmap representing the contact's presence or a null pixmap if the contact is unknown. See <a class="elRef" href="qpixmap.html#isNull">QPixmap::isNull()</a></dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="classKIMIface.html#a8aa014d82e6cdae7e74a371f25063283" title="Confirm if a given contact is known to the IM application.">isPresent()</a> </dd>
<dd>
<a class="el" href="classKIMIface.html#aa7f8d0c01f12ab13b8faee681d5cc1f3" title="Obtain the IM presence as a i18ned string for the specified contact.">presenceString()</a> </dd>
<dd>
<a class="el" href="classKIMIface.html#a0100d77fb96b40ba5b47ff0eef989178" title="Obtain the IM presence as a number for the specified contact.">presenceStatus()</a> </dd>
<dd>
KABC::Addressee::uid() </dd></dl>
</div>
</div>
<a class="anchor" id="a8aa014d82e6cdae7e74a371f25063283"></a><!-- doxytag: member="KIMIface::isPresent" ref="a8aa014d82e6cdae7e74a371f25063283" args="(const QString &uid)=0" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual bool KIMIface::isPresent </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> & </td>
<td class="paramname"><em>uid</em></td><td>)</td>
<td><code> [pure virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Confirm if a given contact is known to the IM application. </p>
<p>Check if you can map the given KABC UID to one if the IM-contacts, e.g. the would be part of the list returned by <a class="el" href="classKIMIface.html#a6dec061f109a7929b95b29ae6beade55" title="Obtain a list of IM-contacts that are known to the application.">allContacts()</a></p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">uid</td><td>the KABC UID you are interested in </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>whether the program knows of this KABC UID</dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="classKIMIface.html#a6dec061f109a7929b95b29ae6beade55" title="Obtain a list of IM-contacts that are known to the application.">allContacts()</a> </dd>
<dd>
<a class="el" href="classKIMIface.html#aa7f8d0c01f12ab13b8faee681d5cc1f3" title="Obtain the IM presence as a i18ned string for the specified contact.">presenceString()</a> </dd>
<dd>
<a class="el" href="classKIMIface.html#a0100d77fb96b40ba5b47ff0eef989178" title="Obtain the IM presence as a number for the specified contact.">presenceStatus()</a> </dd>
<dd>
KABC::Addressee::uid() </dd></dl>
</div>
</div>
<a class="anchor" id="ad7d53da7ae9a4208633a6488f2ea1ac5"></a><!-- doxytag: member="KIMIface::locate" ref="ad7d53da7ae9a4208633a6488f2ea1ac5" args="(const QString &contactId, const QString &protocol)=0" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual <a class="elRef" href="qstring.html">QString</a> KIMIface::locate </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> & </td>
<td class="paramname"><em>contactId</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> & </td>
<td class="paramname"><em>protocol</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td><code> [pure virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Obtain the KABC UID corresponding to the given IM address. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">contactId</td><td>the protocol specific identifier for the contact, e.g. UIN for ICQ, screenname for AIM, nick for IRC </td></tr>
<tr><td class="paramname">protocol</td><td>the IM protocol/service to check. See <a class="el" href="classKIMIface.html#a8cd2b852952e0d2072bafff36ef928c4" title="Obtain a list of supported IM services/protocols.">protocols()</a> </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>the KABC UID for the given contact or <code>QString::null</code> if not found or either input stream was empty or the protocol is not supported</dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="classKIMIface.html#a8cd2b852952e0d2072bafff36ef928c4" title="Obtain a list of supported IM services/protocols.">protocols()</a> </dd>
<dd>
<a class="el" href="classKIMIface.html#ab0e1a3c192e4c0ddc2c39d00b68fbc26" title="Add a new contact given its protocol specific identifier.">addContact()</a> </dd>
<dd>
<a class="el" href="classKIMIface.html#a8aa014d82e6cdae7e74a371f25063283" title="Confirm if a given contact is known to the IM application.">isPresent()</a> </dd>
<dd>
KABC::Addressee::uid() </dd></dl>
</div>
</div>
<a class="anchor" id="afa35037e419a99d19eecae6eb49cb076"></a><!-- doxytag: member="KIMIface::messageContact" ref="afa35037e419a99d19eecae6eb49cb076" args="(const QString &uid, const QString &message)=0" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual void KIMIface::messageContact </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> & </td>
<td class="paramname"><em>uid</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> & </td>
<td class="paramname"><em>message</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td><code> [pure virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Send a single message to the specified contact. </p>
<p>Any response will be handled by the IM client as a normal conversation.</p>
<p>Implementations might send the message silently, ask the user for permission or just prefill the usual message input GUI.</p>
<dl class="note"><dt><b>Note:</b></dt><dd>As sending any text could potentially be a breach of the user's privacy it is recommended to let the user know about it.</dd></dl>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">uid</td><td>the KABC UID you want to send the message to </td></tr>
<tr><td class="paramname">message</td><td>the message text to send to the contact</td></tr>
</table>
</dd>
</dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="classKIMIface.html#af76a5092a737fd26aef8be599ffebda6" title="Send a single message to a contact given only its protocol specific identifier.">messageNewContact()</a> </dd>
<dd>
<a class="el" href="classKIMIface.html#a56e9a33392f0cdb09ba632d839d615f4" title="Start a chat session with the specified contact.">chatWithContact()</a> </dd>
<dd>
<a class="el" href="classKIMIface.html#a1aa51b4d57343ebcb6cf2c4f9fcd62f8" title="Send a file to the contact.">sendFile()</a> </dd>
<dd>
<a class="el" href="classKIMIface.html#a8aa014d82e6cdae7e74a371f25063283" title="Confirm if a given contact is known to the IM application.">isPresent()</a> </dd>
<dd>
<a class="el" href="classKIMIface.html#a1f3c8cce3e1ab97cb2a0775f46f78592" title="Obtain a list of IM-contacts that are currently reachable.">reachableContacts()</a> </dd>
<dd>
KABC::Addressee::uid() </dd></dl>
</div>
</div>
<a class="anchor" id="af76a5092a737fd26aef8be599ffebda6"></a><!-- doxytag: member="KIMIface::messageNewContact" ref="af76a5092a737fd26aef8be599ffebda6" args="(const QString &contactId, const QString &protocol)=0" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual void KIMIface::messageNewContact </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> & </td>
<td class="paramname"><em>contactId</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> & </td>
<td class="paramname"><em>protocol</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td><code> [pure virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Send a single message to a contact given only its protocol specific identifier. </p>
<p>This could be used to send a message without having to know the KABC UID of the contact or without having to add it first.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">contactId</td><td>the protocol specific identifier for the contact, e.g. UIN for ICQ, screenname for AIM, nick for IRC </td></tr>
<tr><td class="paramname">protocol</td><td>the IM protocol/service to check. See <a class="el" href="classKIMIface.html#a8cd2b852952e0d2072bafff36ef928c4" title="Obtain a list of supported IM services/protocols.">protocols()</a></td></tr>
</table>
</dd>
</dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="classKIMIface.html#afa35037e419a99d19eecae6eb49cb076" title="Send a single message to the specified contact.">messageContact()</a> </dd>
<dd>
<a class="el" href="classKIMIface.html#a56e9a33392f0cdb09ba632d839d615f4" title="Start a chat session with the specified contact.">chatWithContact()</a> </dd>
<dd>
<a class="el" href="classKIMIface.html#a1aa51b4d57343ebcb6cf2c4f9fcd62f8" title="Send a file to the contact.">sendFile()</a> </dd>
<dd>
<a class="el" href="classKIMIface.html#ad7d53da7ae9a4208633a6488f2ea1ac5" title="Obtain the KABC UID corresponding to the given IM address.">locate()</a> </dd>
<dd>
<a class="el" href="classKIMIface.html#a8cd2b852952e0d2072bafff36ef928c4" title="Obtain a list of supported IM services/protocols.">protocols()</a> </dd>
<dd>
<a class="el" href="classKIMIface.html#ab0e1a3c192e4c0ddc2c39d00b68fbc26" title="Add a new contact given its protocol specific identifier.">addContact()</a> </dd></dl>
</div>
</div>
<a class="anchor" id="a098efa69d4e27164b8092cfa021e031e"></a><!-- doxytag: member="KIMIface::onlineContacts" ref="a098efa69d4e27164b8092cfa021e031e" args="()=0" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual <a class="elRef" href="qstringlist.html">QStringList</a> KIMIface::onlineContacts </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td><code> [pure virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Obtain a list of IM-contacts that are currently online. </p>
<p>Return a list of KABC UIDs of the contacts you have any presence information for that indicates that they are connected to the IM-service they are associated with.</p>
<dl class="return"><dt><b>Returns:</b></dt><dd>a list of KABC UIDs who are online with unspecified presence</dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="classKIMIface.html#a6dec061f109a7929b95b29ae6beade55" title="Obtain a list of IM-contacts that are known to the application.">allContacts()</a> </dd>
<dd>
<a class="el" href="classKIMIface.html#a1f3c8cce3e1ab97cb2a0775f46f78592" title="Obtain a list of IM-contacts that are currently reachable.">reachableContacts()</a> </dd>
<dd>
<a class="el" href="classKIMIface.html#a195de9417f76fa8d88302405de9284a1" title="Obtain a list of IM-contacts who may receive file transfers.">fileTransferContacts()</a> </dd>
<dd>
<a class="el" href="classKIMIface.html#afa35037e419a99d19eecae6eb49cb076" title="Send a single message to the specified contact.">messageContact()</a> </dd>
<dd>
<a class="el" href="classKIMIface.html#a56e9a33392f0cdb09ba632d839d615f4" title="Start a chat session with the specified contact.">chatWithContact()</a> </dd>
<dd>
KABC::Addressee::uid() </dd></dl>
</div>
</div>
<a class="anchor" id="a0100d77fb96b40ba5b47ff0eef989178"></a><!-- doxytag: member="KIMIface::presenceStatus" ref="a0100d77fb96b40ba5b47ff0eef989178" args="(const QString &uid)=0" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual int KIMIface::presenceStatus </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> & </td>
<td class="paramname"><em>uid</em></td><td>)</td>
<td><code> [pure virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Obtain the IM presence as a number for the specified contact. </p>
<p>Return one of the following values depending on the given contact's presence:</p>
<ul>
<li>0 - <code>Unknown:</code> for contacts where you can not use any of the other values</li>
</ul>
<ul>
<li>1 - <code>Offline:</code> for contacts that are offline, i.e. not connected to their IM-service. If the application itself or the IM-service for the given contact is offline return <code>Unknown</code> instead</li>
</ul>
<ul>
<li>2 - <code>Connecting</code> </li>
</ul>
<ul>
<li>3 - <code>Away:</code> for contacts that are connected to their IM-service but not <code>Online</code> </li>
</ul>
<ul>
<li>4 - <code>Online</code> </li>
</ul>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">uid</td><td>the KABC UID you want the presence for </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>a numeric representation of presence - currently one of 0 (Unknown), 1 (Offline), 2 (Connecting), 3 (Away), 4 (Online). Returns 0 if the given UID is unknown</dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="classKIMIface.html#a8aa014d82e6cdae7e74a371f25063283" title="Confirm if a given contact is known to the IM application.">isPresent()</a> </dd>
<dd>
<a class="el" href="classKIMIface.html#aa7f8d0c01f12ab13b8faee681d5cc1f3" title="Obtain the IM presence as a i18ned string for the specified contact.">presenceString()</a> </dd>
<dd>
KABC::Addressee::uid() </dd></dl>
</div>
</div>
<a class="anchor" id="aa7f8d0c01f12ab13b8faee681d5cc1f3"></a><!-- doxytag: member="KIMIface::presenceString" ref="aa7f8d0c01f12ab13b8faee681d5cc1f3" args="(const QString &uid)=0" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual <a class="elRef" href="qstring.html">QString</a> KIMIface::presenceString </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> & </td>
<td class="paramname"><em>uid</em></td><td>)</td>
<td><code> [pure virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Obtain the IM presence as a i18ned string for the specified contact. </p>
<p>Return a translated string your application would use when displaying the contact's presence, e.g. i18n("Online"), i18n("Away")</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">uid</td><td>the KABC UID you want the presence for </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>the i18ned string describing the contact's presence or QString::null if the UID is unknown</dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="classKIMIface.html#a8aa014d82e6cdae7e74a371f25063283" title="Confirm if a given contact is known to the IM application.">isPresent()</a> </dd>
<dd>
<a class="el" href="classKIMIface.html#a0100d77fb96b40ba5b47ff0eef989178" title="Obtain the IM presence as a number for the specified contact.">presenceStatus()</a> </dd>
<dd>
KABC::Addressee::uid() </dd></dl>
</div>
</div>
<a class="anchor" id="a8cd2b852952e0d2072bafff36ef928c4"></a><!-- doxytag: member="KIMIface::protocols" ref="a8cd2b852952e0d2072bafff36ef928c4" args="()=0" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual <a class="elRef" href="qstringlist.html">QStringList</a> KIMIface::protocols </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td><code> [pure virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Obtain a list of supported IM services/protocols. </p>
<p>Protocol names are currently of the form "protocol name" + "Protocol" for example:</p>
<ul>
<li>AIMProtocol: AOL instant messenger protocol</li>
<li>MSNProtocol: Microsoft messanger protocol</li>
<li>ICQProtocol: AOL (Mirabilis) ICQ protocol</li>
<li>....</li>
</ul>
<p>The string is currently just an identifier to use with methods such as <a class="el" href="classKIMIface.html#ad7d53da7ae9a4208633a6488f2ea1ac5" title="Obtain the KABC UID corresponding to the given IM address.">locate()</a>, <a class="el" href="classKIMIface.html#ab0e1a3c192e4c0ddc2c39d00b68fbc26" title="Add a new contact given its protocol specific identifier.">addContact()</a> or <a class="el" href="classKIMIface.html#af76a5092a737fd26aef8be599ffebda6" title="Send a single message to a contact given only its protocol specific identifier.">messageNewContact()</a></p>
<dl class="return"><dt><b>Returns:</b></dt><dd>the set of protocols that the application supports</dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="classKIMIface.html#ad7d53da7ae9a4208633a6488f2ea1ac5" title="Obtain the KABC UID corresponding to the given IM address.">locate()</a> </dd>
<dd>
<a class="el" href="classKIMIface.html#ab0e1a3c192e4c0ddc2c39d00b68fbc26" title="Add a new contact given its protocol specific identifier.">addContact()</a> </dd>
<dd>
<a class="el" href="classKIMIface.html#af76a5092a737fd26aef8be599ffebda6" title="Send a single message to a contact given only its protocol specific identifier.">messageNewContact</a> </dd></dl>
</div>
</div>
<a class="anchor" id="a1f3c8cce3e1ab97cb2a0775f46f78592"></a><!-- doxytag: member="KIMIface::reachableContacts" ref="a1f3c8cce3e1ab97cb2a0775f46f78592" args="()=0" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual <a class="elRef" href="qstringlist.html">QStringList</a> KIMIface::reachableContacts </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td><code> [pure virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Obtain a list of IM-contacts that are currently reachable. </p>
<p>Return a list of KABC UIDs of the contacts that are reachable in the sense that you are connected to the IM-service they are associated with.</p>
<p>For example if your application supports ICQ and AIM and the ICQ account is active but the AIM account isn't, return just the ICQ contacts.</p>
<dl class="return"><dt><b>Returns:</b></dt><dd>a list of KABC UIDs who can receive a message, even if offline</dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="classKIMIface.html#a6dec061f109a7929b95b29ae6beade55" title="Obtain a list of IM-contacts that are known to the application.">allContacts()</a> </dd>
<dd>
<a class="el" href="classKIMIface.html#a098efa69d4e27164b8092cfa021e031e" title="Obtain a list of IM-contacts that are currently online.">onlineContacts()</a> </dd>
<dd>
<a class="el" href="classKIMIface.html#a195de9417f76fa8d88302405de9284a1" title="Obtain a list of IM-contacts who may receive file transfers.">fileTransferContacts()</a> </dd>
<dd>
<a class="el" href="classKIMIface.html#afa35037e419a99d19eecae6eb49cb076" title="Send a single message to the specified contact.">messageContact()</a> </dd>
<dd>
KABC::Addressee::uid() </dd></dl>
</div>
</div>
<a class="anchor" id="a1aa51b4d57343ebcb6cf2c4f9fcd62f8"></a><!-- doxytag: member="KIMIface::sendFile" ref="a1aa51b4d57343ebcb6cf2c4f9fcd62f8" args="(const QString &uid, const KURL &sourceURL, const QString &altFileName=QString::null, uint fileSize=0)=0" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual void KIMIface::sendFile </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> & </td>
<td class="paramname"><em>uid</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="elRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/classKURL.html">KURL</a> & </td>
<td class="paramname"><em>sourceURL</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> & </td>
<td class="paramname"><em>altFileName</em> = <code>QString::null</code>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">uint </td>
<td class="paramname"><em>fileSize</em> = <code>0</code> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td><code> [pure virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Send a file to the contact. </p>
<p>Initiates a file transfer with the given contact if possible.</p>
<p>Implementations might start the transfer right away, ask the user's permission or just prefill the usual file transfer GUI.</p>
<dl class="note"><dt><b>Note:</b></dt><dd>As sending any file could potentially be a breach of the user's privacy it is recommended to let the user know about it.</dd></dl>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">uid</td><td>the KABC UID you want to send to </td></tr>
<tr><td class="paramname">sourceURL</td><td>a <a class="elRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/classKURL.html">KURL</a> pointing to the file to send </td></tr>
<tr><td class="paramname">altFileName</td><td>an alternate filename describing the file or a description or title </td></tr>
<tr><td class="paramname">fileSize</td><td>file size in bytes</td></tr>
</table>
</dd>
</dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="classKIMIface.html#afa35037e419a99d19eecae6eb49cb076" title="Send a single message to the specified contact.">messageContact()</a> </dd>
<dd>
<a class="el" href="classKIMIface.html#af76a5092a737fd26aef8be599ffebda6" title="Send a single message to a contact given only its protocol specific identifier.">messageNewContact()</a> </dd>
<dd>
<a class="el" href="classKIMIface.html#a56e9a33392f0cdb09ba632d839d615f4" title="Start a chat session with the specified contact.">chatWithContact()</a> </dd>
<dd>
<a class="el" href="classKIMIface.html#a8aa014d82e6cdae7e74a371f25063283" title="Confirm if a given contact is known to the IM application.">isPresent()</a> </dd>
<dd>
<a class="el" href="classKIMIface.html#a195de9417f76fa8d88302405de9284a1" title="Obtain a list of IM-contacts who may receive file transfers.">fileTransferContacts()</a> </dd>
<dd>
KABC::Addressee::uid() </dd></dl>
</div>
</div>
<hr/>The documentation for this class was generated from the following file:<ul>
<li><a class="el" href="kimiface_8h_source.html">kimiface.h</a></li>
</ul>
</div>
</div></div>
</td>
</tr>
<tr>
<td valign="top" id="leftmenu" width="25%">
<a name="navigation"></a>
<div class="menu_box"><h2>interfaces</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></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="classExtTerminalInterface.html">extterminalinterface</option>, <option value="classKFileAudioPreview.html">kfileaudiopreview</option>, <option value="classKHE_1_1BytesEditInterface.html">khe::byteseditinterface</option>, <option value="classKHE_1_1CharColumnInterface.html">khe::charcolumninterface</option>, <option value="classKHE_1_1ClipboardInterface.html">khe::clipboardinterface</option>, <option value="classKHE_1_1ValueColumnInterface.html">khe::valuecolumninterface</option>, <option value="classKHE_1_1ZoomInterface.html">khe::zoominterface</option>, <option value="classKIMIface.html">kimiface</option>, <option value="classKIMProxy.html">kimproxy</option>, <option value="classKMediaPlayer_1_1Player.html">kmediaplayer::player</option>, <option value="classKMediaPlayer_1_1View.html">kmediaplayer::view</option>, <option value="classKRegExpEditorInterface.html">kregexpeditorinterface</option>, <option value="classKScriptClientInterface.html">kscriptclientinterface</option>, <option value="classKScriptInterface.html">kscriptinterface</option>, <option value="classKScriptManager.html">kscriptmanager</option>, <option value="classKSpeech.html">kspeech</option>, <option value="classKSpeechSink.html">kspeechsink</option>, <option value="classKTextEditor_1_1BlockSelectionDCOPInterface.html">ktexteditor::blockselectiondcopinterface</option>, <option value="classKTextEditor_1_1BlockSelectionInterface.html">ktexteditor::blockselectioninterface</option>, <option value="classKTextEditor_1_1ClipboardDCOPInterface.html">ktexteditor::clipboarddcopinterface</option>, <option value="classKTextEditor_1_1ClipboardInterface.html">ktexteditor::clipboardinterface</option>, <option value="classKTextEditor_1_1CodeCompletionInterface.html">ktexteditor::codecompletioninterface</option>, <option value="classKTextEditor_1_1CompletionEntry.html">ktexteditor::completionentry</option>, <option value="classKTextEditor_1_1ConfigInterface.html">ktexteditor::configinterface</option>, <option value="classKTextEditor_1_1ConfigInterfaceExtension.html">ktexteditor::configinterfaceextension</option>, <option value="classKTextEditor_1_1Cursor.html">ktexteditor::cursor</option>, <option value="classKTextEditor_1_1CursorInterface.html">ktexteditor::cursorinterface</option>, <option value="classKTextEditor_1_1Document.html">ktexteditor::document</option>, <option value="classKTextEditor_1_1DocumentInfoDCOPInterface.html">ktexteditor::documentinfodcopinterface</option>, <option value="classKTextEditor_1_1DocumentInfoInterface.html">ktexteditor::documentinfointerface</option>, <option value="classKTextEditor_1_1DynWordWrapInterface.html">ktexteditor::dynwordwrapinterface</option>, <option value="classKTextEditor_1_1EditDCOPInterface.html">ktexteditor::editdcopinterface</option>, <option value="classKTextEditor_1_1EditInterface.html">ktexteditor::editinterface</option>, <option value="classKTextEditor_1_1EditInterfaceExt.html">ktexteditor::editinterfaceext</option>, <option value="classKTextEditor_1_1Editor.html">ktexteditor::editor</option>, <option value="classKTextEditor_1_1EncodingDCOPInterface.html">ktexteditor::encodingdcopinterface</option>, <option value="classKTextEditor_1_1EncodingInterface.html">ktexteditor::encodinginterface</option>, <option value="classKTextEditor_1_1HighlightingInterface.html">ktexteditor::highlightinginterface</option>, <option value="classKTextEditor_1_1MarkInterface.html">ktexteditor::markinterface</option>, <option value="classKTextEditor_1_1MarkInterfaceExtension.html">ktexteditor::markinterfaceextension</option>, <option value="classKTextEditor_1_1Plugin.html">ktexteditor::plugin</option>, <option value="classKTextEditor_1_1PluginViewInterface.html">ktexteditor::pluginviewinterface</option>, <option value="classKTextEditor_1_1PopupMenuInterface.html">ktexteditor::popupmenuinterface</option>, <option value="classKTextEditor_1_1PrintDCOPInterface.html">ktexteditor::printdcopinterface</option>, <option value="classKTextEditor_1_1PrintInterface.html">ktexteditor::printinterface</option>, <option value="classKTextEditor_1_1SearchDCOPInterface.html">ktexteditor::searchdcopinterface</option>, <option value="classKTextEditor_1_1SearchInterface.html">ktexteditor::searchinterface</option>, <option value="classKTextEditor_1_1SelectionDCOPInterface.html">ktexteditor::selectiondcopinterface</option>, <option value="classKTextEditor_1_1SelectionExtDCOPInterface.html">ktexteditor::selectionextdcopinterface</option>, <option value="classKTextEditor_1_1SelectionInterface.html">ktexteditor::selectioninterface</option>, <option value="classKTextEditor_1_1SelectionInterfaceExt.html">ktexteditor::selectioninterfaceext</option>, <option value="classKTextEditor_1_1SessionConfigInterface.html">ktexteditor::sessionconfiginterface</option>, <option value="classKTextEditor_1_1TemplateInterface.html">ktexteditor::templateinterface</option>, <option value="classKTextEditor_1_1TextHintInterface.html">ktexteditor::texthintinterface</option>, <option value="classKTextEditor_1_1UndoDCOPInterface.html">ktexteditor::undodcopinterface</option>, <option value="classKTextEditor_1_1UndoInterface.html">ktexteditor::undointerface</option>, <option value="classKTextEditor_1_1VariableInterface.html">ktexteditor::variableinterface</option>, <option value="classKTextEditor_1_1View.html">ktexteditor::view</option>, <option value="classKTextEditor_1_1ViewCursorDCOPInterface.html">ktexteditor::viewcursordcopinterface</option>, <option value="classKTextEditor_1_1ViewCursorInterface.html">ktexteditor::viewcursorinterface</option>, <option value="classKTextEditor_1_1ViewStatusMsgDCOPInterface.html">ktexteditor::viewstatusmsgdcopinterface</option>, <option value="classKTextEditor_1_1ViewStatusMsgInterface.html">ktexteditor::viewstatusmsginterface</option>, <option value="classKTextEditor_1_1WordWrapInterface.html">ktexteditor::wordwrapinterface</option>, <option value="classScriptLoader.html">scriptloader</option>, <option value="classTerminalInterface.html">terminalinterface</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>
