1
<?xml version="1.0" encoding="iso-8859-1"?>
3
PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "DTD/xhtml1-strict.dtd">
4
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
6
<title>Tp::Client::ProtocolInterfaceAddressingInterface Class Reference</title>
7
<link href="doxygen.css" rel="stylesheet" type="text/css" />
10
<table border="0" cellpadding="0" cellspacing="0" width="100%">
12
<td width="1"> </td>
13
<td class="postheader" valign="center">
15
<font color="#004faf">Home</font></a> ·
16
<a href="classes.html">
17
<font color="#004faf">All Classes</font></a> ·
18
<a href="namespaces.html">
19
<font color="#004faf">All Namespaces</font></a> ·
20
<a href="modules.html">
21
<font color="#004faf">Modules</font></a> ·
22
<a href="functions.html">
23
<font color="#004faf">Functions</font></a> ·
25
<font color="#004faf">Files</font></a>
29
<!-- Generated by Doxygen 1.8.5 -->
30
<div id="nav-path" class="navpath">
32
<li class="navelem"><a class="el" href="a00860.html">Tp</a></li><li class="navelem"><a class="el" href="a00864.html">Client</a></li><li class="navelem"><a class="el" href="a00470.html">ProtocolInterfaceAddressingInterface</a></li> </ul>
37
<a href="#pub-slots">Public Slots</a> |
38
<a href="#pub-methods">Public Member Functions</a> |
39
<a href="#pub-static-methods">Static Public Member Functions</a> |
40
<a href="#pro-methods">Protected Member Functions</a> |
41
<a href="a01293.html">List of all members</a> </div>
42
<div class="headertitle">
43
<div class="title">Tp::Client::ProtocolInterfaceAddressingInterface Class Reference<div class="ingroups"><a class="el" href="a00881.html">Connection manager proxies</a></div></div> </div>
45
<div class="contents">
47
<p><code>#include <<a class="el" href="a00636_source.html">TelepathyQt/ConnectionManager</a>></code></p>
49
<p>Inherits <a class="el" href="a00070.html">Tp::AbstractInterface</a>.</p>
50
<table class="memberdecls">
51
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="pub-slots"></a>
52
Public Slots</h2></td></tr>
53
<tr class="memitem:a7e5d861026881f3a8166ffff910e06d3"><td class="memItemLeft" align="right" valign="top">QDBusPendingReply< QString > </td><td class="memItemRight" valign="bottom"><a class="el" href="a00470.html#a7e5d861026881f3a8166ffff910e06d3">NormalizeVCardAddress</a> (const QString &VCardField, const QString &VCardAddress, int timeout=-1)</td></tr>
54
<tr class="separator:a7e5d861026881f3a8166ffff910e06d3"><td class="memSeparator" colspan="2"> </td></tr>
55
<tr class="memitem:a79088c750137c2a24449c963899252cd"><td class="memItemLeft" align="right" valign="top">QDBusPendingReply< QString > </td><td class="memItemRight" valign="bottom"><a class="el" href="a00470.html#a79088c750137c2a24449c963899252cd">NormalizeContactURI</a> (const QString &URI, int timeout=-1)</td></tr>
56
<tr class="separator:a79088c750137c2a24449c963899252cd"><td class="memSeparator" colspan="2"> </td></tr>
57
</table><table class="memberdecls">
58
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="pub-methods"></a>
59
Public Member Functions</h2></td></tr>
60
<tr class="memitem:ab3ac0c8c2d05973e108109bdf3b74670"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="a00470.html#ab3ac0c8c2d05973e108109bdf3b74670">ProtocolInterfaceAddressingInterface</a> (const QString &busName, const QString &objectPath, QObject *parent=0)</td></tr>
61
<tr class="separator:ab3ac0c8c2d05973e108109bdf3b74670"><td class="memSeparator" colspan="2"> </td></tr>
62
<tr class="memitem:a4ac4219366eba255ae094592dda05c52"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="a00470.html#a4ac4219366eba255ae094592dda05c52">ProtocolInterfaceAddressingInterface</a> (const QDBusConnection &connection, const QString &busName, const QString &objectPath, QObject *parent=0)</td></tr>
63
<tr class="separator:a4ac4219366eba255ae094592dda05c52"><td class="memSeparator" colspan="2"> </td></tr>
64
<tr class="memitem:a4f837214fa74ceace80e2b58d0fad92c"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="a00470.html#a4f837214fa74ceace80e2b58d0fad92c">ProtocolInterfaceAddressingInterface</a> (<a class="el" href="a00339.html">Tp::DBusProxy</a> *proxy)</td></tr>
65
<tr class="separator:a4f837214fa74ceace80e2b58d0fad92c"><td class="memSeparator" colspan="2"> </td></tr>
66
<tr class="memitem:af032f4afe6c8a48cefa21fca878be828"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="a00470.html#af032f4afe6c8a48cefa21fca878be828">ProtocolInterfaceAddressingInterface</a> (const <a class="el" href="a00311.html">Tp::Client::ConnectionManagerInterface</a> &mainInterface)</td></tr>
67
<tr class="separator:af032f4afe6c8a48cefa21fca878be828"><td class="memSeparator" colspan="2"> </td></tr>
68
<tr class="memitem:a63f5d273c06f04544da005083ca551c8"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="a00470.html#a63f5d273c06f04544da005083ca551c8">ProtocolInterfaceAddressingInterface</a> (const <a class="el" href="a00311.html">Tp::Client::ConnectionManagerInterface</a> &mainInterface, QObject *parent)</td></tr>
69
<tr class="separator:a63f5d273c06f04544da005083ca551c8"><td class="memSeparator" colspan="2"> </td></tr>
70
<tr class="memitem:a721bca967bc332882ffc976be4a43af6"><td class="memItemLeft" align="right" valign="top"><a class="el" href="a00452.html">Tp::PendingVariant</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="a00470.html#a721bca967bc332882ffc976be4a43af6">requestPropertyAddressableVCardFields</a> () const </td></tr>
71
<tr class="separator:a721bca967bc332882ffc976be4a43af6"><td class="memSeparator" colspan="2"> </td></tr>
72
<tr class="memitem:a3164a117332272810ca7f8cc089a219e"><td class="memItemLeft" align="right" valign="top"><a class="el" href="a00452.html">Tp::PendingVariant</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="a00470.html#a3164a117332272810ca7f8cc089a219e">requestPropertyAddressableURISchemes</a> () const </td></tr>
73
<tr class="separator:a3164a117332272810ca7f8cc089a219e"><td class="memSeparator" colspan="2"> </td></tr>
74
<tr class="memitem:a238777bf0c352ab646890749a744acb5"><td class="memItemLeft" align="right" valign="top"><a class="el" href="a00453.html">Tp::PendingVariantMap</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="a00470.html#a238777bf0c352ab646890749a744acb5">requestAllProperties</a> () const </td></tr>
75
<tr class="separator:a238777bf0c352ab646890749a744acb5"><td class="memSeparator" colspan="2"> </td></tr>
76
<tr class="inherit_header pub_methods_a00070"><td colspan="2" onclick="javascript:toggleInherit('pub_methods_a00070')"><img src="closed.png" alt="-"/> Public Member Functions inherited from <a class="el" href="a00070.html">Tp::AbstractInterface</a></td></tr>
77
<tr class="memitem:ad82f1079204bca0dcfd1f6eeda3b0bcf inherit pub_methods_a00070"><td class="memItemLeft" align="right" valign="top">virtual </td><td class="memItemRight" valign="bottom"><a class="el" href="a00070.html#ad82f1079204bca0dcfd1f6eeda3b0bcf">~AbstractInterface</a> ()</td></tr>
78
<tr class="separator:ad82f1079204bca0dcfd1f6eeda3b0bcf inherit pub_methods_a00070"><td class="memSeparator" colspan="2"> </td></tr>
79
<tr class="memitem:a6ffad807cd688510af39c9ddd808d5b5 inherit pub_methods_a00070"><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="a00070.html#a6ffad807cd688510af39c9ddd808d5b5">isValid</a> () const </td></tr>
80
<tr class="separator:a6ffad807cd688510af39c9ddd808d5b5 inherit pub_methods_a00070"><td class="memSeparator" colspan="2"> </td></tr>
81
<tr class="memitem:a8bf99ab34d551325914c08500acadc94 inherit pub_methods_a00070"><td class="memItemLeft" align="right" valign="top">QString </td><td class="memItemRight" valign="bottom"><a class="el" href="a00070.html#a8bf99ab34d551325914c08500acadc94">invalidationReason</a> () const </td></tr>
82
<tr class="separator:a8bf99ab34d551325914c08500acadc94 inherit pub_methods_a00070"><td class="memSeparator" colspan="2"> </td></tr>
83
<tr class="memitem:a96caf6bfea37a71d4849b4470728ceb4 inherit pub_methods_a00070"><td class="memItemLeft" align="right" valign="top">QString </td><td class="memItemRight" valign="bottom"><a class="el" href="a00070.html#a96caf6bfea37a71d4849b4470728ceb4">invalidationMessage</a> () const </td></tr>
84
<tr class="separator:a96caf6bfea37a71d4849b4470728ceb4 inherit pub_methods_a00070"><td class="memSeparator" colspan="2"> </td></tr>
85
<tr class="memitem:a6b4af7363d43822a32fdd3fa56108424 inherit pub_methods_a00070"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="a00070.html#a6b4af7363d43822a32fdd3fa56108424">setMonitorProperties</a> (bool monitorProperties)</td></tr>
86
<tr class="separator:a6b4af7363d43822a32fdd3fa56108424 inherit pub_methods_a00070"><td class="memSeparator" colspan="2"> </td></tr>
87
<tr class="memitem:a3714c9535fdd183a175c1b1e668f4ec7 inherit pub_methods_a00070"><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="a00070.html#a3714c9535fdd183a175c1b1e668f4ec7">isMonitoringProperties</a> () const </td></tr>
88
<tr class="separator:a3714c9535fdd183a175c1b1e668f4ec7 inherit pub_methods_a00070"><td class="memSeparator" colspan="2"> </td></tr>
89
</table><table class="memberdecls">
90
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="pub-static-methods"></a>
91
Static Public Member Functions</h2></td></tr>
92
<tr class="memitem:a238dae2975d564211a604d8abcc53d99"><td class="memItemLeft" align="right" valign="top">static QLatin1String </td><td class="memItemRight" valign="bottom"><a class="el" href="a00470.html#a238dae2975d564211a604d8abcc53d99">staticInterfaceName</a> ()</td></tr>
93
<tr class="separator:a238dae2975d564211a604d8abcc53d99"><td class="memSeparator" colspan="2"> </td></tr>
94
</table><table class="memberdecls">
95
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="pro-methods"></a>
96
Protected Member Functions</h2></td></tr>
97
<tr class="memitem:a2e2fb91a802acb07243e857da962ac34"><td class="memItemLeft" align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><a class="el" href="a00470.html#a2e2fb91a802acb07243e857da962ac34">invalidate</a> (<a class="el" href="a00339.html">Tp::DBusProxy</a> *, const QString &, const QString &)</td></tr>
98
<tr class="separator:a2e2fb91a802acb07243e857da962ac34"><td class="memSeparator" colspan="2"> </td></tr>
99
<tr class="inherit_header pro_methods_a00070"><td colspan="2" onclick="javascript:toggleInherit('pro_methods_a00070')"><img src="closed.png" alt="-"/> Protected Member Functions inherited from <a class="el" href="a00070.html">Tp::AbstractInterface</a></td></tr>
100
<tr class="memitem:ae73665dbe1abf1c50a8ab98221274dbe inherit pro_methods_a00070"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="a00070.html#ae73665dbe1abf1c50a8ab98221274dbe">AbstractInterface</a> (<a class="el" href="a00339.html">DBusProxy</a> *proxy, const QLatin1String &interface)</td></tr>
101
<tr class="separator:ae73665dbe1abf1c50a8ab98221274dbe inherit pro_methods_a00070"><td class="memSeparator" colspan="2"> </td></tr>
102
<tr class="memitem:a454ff620101be4299892b3e47fead4d2 inherit pro_methods_a00070"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="a00070.html#a454ff620101be4299892b3e47fead4d2">AbstractInterface</a> (const QString &busName, const QString &path, const QLatin1String &interface, const QDBusConnection &connection, QObject *parent)</td></tr>
103
<tr class="separator:a454ff620101be4299892b3e47fead4d2 inherit pro_methods_a00070"><td class="memSeparator" colspan="2"> </td></tr>
104
<tr class="memitem:ad97c6346a1c2bbfd893943d60da27b89 inherit pro_methods_a00070"><td class="memItemLeft" align="right" valign="top"><a class="el" href="a00452.html">PendingVariant</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="a00070.html#ad97c6346a1c2bbfd893943d60da27b89">internalRequestProperty</a> (const QString &name) const </td></tr>
105
<tr class="separator:ad97c6346a1c2bbfd893943d60da27b89 inherit pro_methods_a00070"><td class="memSeparator" colspan="2"> </td></tr>
106
<tr class="memitem:a735ab438b3675c6938cd534722c47b4e inherit pro_methods_a00070"><td class="memItemLeft" align="right" valign="top"><a class="el" href="a00443.html">PendingOperation</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="a00070.html#a735ab438b3675c6938cd534722c47b4e">internalSetProperty</a> (const QString &name, const QVariant &newValue)</td></tr>
107
<tr class="separator:a735ab438b3675c6938cd534722c47b4e inherit pro_methods_a00070"><td class="memSeparator" colspan="2"> </td></tr>
108
<tr class="memitem:a0fe684d0ef843a3e36f2ecee24defed6 inherit pro_methods_a00070"><td class="memItemLeft" align="right" valign="top"><a class="el" href="a00453.html">PendingVariantMap</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="a00070.html#a0fe684d0ef843a3e36f2ecee24defed6">internalRequestAllProperties</a> () const </td></tr>
109
<tr class="separator:a0fe684d0ef843a3e36f2ecee24defed6 inherit pro_methods_a00070"><td class="memSeparator" colspan="2"> </td></tr>
110
</table><table class="memberdecls">
111
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="inherited"></a>
112
Additional Inherited Members</h2></td></tr>
113
<tr class="inherit_header signals_a00070"><td colspan="2" onclick="javascript:toggleInherit('signals_a00070')"><img src="closed.png" alt="-"/> Signals inherited from <a class="el" href="a00070.html">Tp::AbstractInterface</a></td></tr>
114
<tr class="memitem:a1c7549c77596f07f241e361c5124119d inherit signals_a00070"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="a00070.html#a1c7549c77596f07f241e361c5124119d">propertiesChanged</a> (const QVariantMap &changedProperties, const QStringList &invalidatedProperties)</td></tr>
115
<tr class="separator:a1c7549c77596f07f241e361c5124119d inherit signals_a00070"><td class="memSeparator" colspan="2"> </td></tr>
116
<tr class="inherit_header pro_slots_a00070"><td colspan="2" onclick="javascript:toggleInherit('pro_slots_a00070')"><img src="closed.png" alt="-"/> Protected Slots inherited from <a class="el" href="a00070.html">Tp::AbstractInterface</a></td></tr>
118
<a name="details" id="details"></a><h2 class="groupheader">Detailed Description</h2>
119
<div class="textblock"><p>Proxy class providing a 1:1 mapping of the D-Bus interface "org.freedesktop.Telepathy.Protocol.Interface.Addressing". </p>
120
</div><h2 class="groupheader">Constructor & Destructor Documentation</h2>
121
<a class="anchor" id="ab3ac0c8c2d05973e108109bdf3b74670"></a>
122
<div class="memitem">
123
<div class="memproto">
124
<table class="memname">
126
<td class="memname">Tp::Client::ProtocolInterfaceAddressingInterface::ProtocolInterfaceAddressingInterface </td>
128
<td class="paramtype">const QString & </td>
129
<td class="paramname"><em>busName</em>, </td>
132
<td class="paramkey"></td>
134
<td class="paramtype">const QString & </td>
135
<td class="paramname"><em>objectPath</em>, </td>
138
<td class="paramkey"></td>
140
<td class="paramtype">QObject * </td>
141
<td class="paramname"><em>parent</em> = <code>0</code> </td>
149
</div><div class="memdoc">
150
<p>Creates a <a class="el" href="a00470.html">ProtocolInterfaceAddressingInterface</a> associated with the given object on the session bus.</p>
151
<dl class="params"><dt>Parameters</dt><dd>
152
<table class="params">
153
<tr><td class="paramname">busName</td><td>Name of the service the object is on. </td></tr>
154
<tr><td class="paramname">objectPath</td><td>Path to the object on the service. </td></tr>
155
<tr><td class="paramname">parent</td><td>Passed to the parent class constructor. </td></tr>
162
<a class="anchor" id="a4ac4219366eba255ae094592dda05c52"></a>
163
<div class="memitem">
164
<div class="memproto">
165
<table class="memname">
167
<td class="memname">Tp::Client::ProtocolInterfaceAddressingInterface::ProtocolInterfaceAddressingInterface </td>
169
<td class="paramtype">const QDBusConnection & </td>
170
<td class="paramname"><em>connection</em>, </td>
173
<td class="paramkey"></td>
175
<td class="paramtype">const QString & </td>
176
<td class="paramname"><em>busName</em>, </td>
179
<td class="paramkey"></td>
181
<td class="paramtype">const QString & </td>
182
<td class="paramname"><em>objectPath</em>, </td>
185
<td class="paramkey"></td>
187
<td class="paramtype">QObject * </td>
188
<td class="paramname"><em>parent</em> = <code>0</code> </td>
196
</div><div class="memdoc">
197
<p>Creates a <a class="el" href="a00470.html">ProtocolInterfaceAddressingInterface</a> associated with the given object on the given bus.</p>
198
<dl class="params"><dt>Parameters</dt><dd>
199
<table class="params">
200
<tr><td class="paramname">connection</td><td>The bus via which the object can be reached. </td></tr>
201
<tr><td class="paramname">busName</td><td>Name of the service the object is on. </td></tr>
202
<tr><td class="paramname">objectPath</td><td>Path to the object on the service. </td></tr>
203
<tr><td class="paramname">parent</td><td>Passed to the parent class constructor. </td></tr>
210
<a class="anchor" id="a4f837214fa74ceace80e2b58d0fad92c"></a>
211
<div class="memitem">
212
<div class="memproto">
213
<table class="memname">
215
<td class="memname">Tp::Client::ProtocolInterfaceAddressingInterface::ProtocolInterfaceAddressingInterface </td>
217
<td class="paramtype"><a class="el" href="a00339.html">Tp::DBusProxy</a> * </td>
218
<td class="paramname"><em>proxy</em></td><td>)</td>
222
</div><div class="memdoc">
223
<p>Creates a <a class="el" href="a00470.html">ProtocolInterfaceAddressingInterface</a> associated with the same object as the given proxy.</p>
224
<dl class="params"><dt>Parameters</dt><dd>
225
<table class="params">
226
<tr><td class="paramname">proxy</td><td>The proxy to use. It will also be the QObject::parent() for this object. </td></tr>
233
<a class="anchor" id="af032f4afe6c8a48cefa21fca878be828"></a>
234
<div class="memitem">
235
<div class="memproto">
236
<table class="mlabels">
238
<td class="mlabels-left">
239
<table class="memname">
241
<td class="memname">Tp::Client::ProtocolInterfaceAddressingInterface::ProtocolInterfaceAddressingInterface </td>
243
<td class="paramtype">const <a class="el" href="a00311.html">Tp::Client::ConnectionManagerInterface</a> & </td>
244
<td class="paramname"><em>mainInterface</em></td><td>)</td>
249
<td class="mlabels-right">
250
<span class="mlabels"><span class="mlabel">explicit</span></span> </td>
253
</div><div class="memdoc">
254
<p>Creates a <a class="el" href="a00470.html">ProtocolInterfaceAddressingInterface</a> associated with the same object as the given proxy. Additionally, the created proxy will have the same parent as the given proxy.</p>
255
<dl class="params"><dt>Parameters</dt><dd>
256
<table class="params">
257
<tr><td class="paramname">mainInterface</td><td>The proxy to use. </td></tr>
264
<a class="anchor" id="a63f5d273c06f04544da005083ca551c8"></a>
265
<div class="memitem">
266
<div class="memproto">
267
<table class="memname">
269
<td class="memname">Tp::Client::ProtocolInterfaceAddressingInterface::ProtocolInterfaceAddressingInterface </td>
271
<td class="paramtype">const <a class="el" href="a00311.html">Tp::Client::ConnectionManagerInterface</a> & </td>
272
<td class="paramname"><em>mainInterface</em>, </td>
275
<td class="paramkey"></td>
277
<td class="paramtype">QObject * </td>
278
<td class="paramname"><em>parent</em> </td>
286
</div><div class="memdoc">
287
<p>Creates a <a class="el" href="a00470.html">ProtocolInterfaceAddressingInterface</a> associated with the same object as the given proxy. However, a different parent object can be specified.</p>
288
<dl class="params"><dt>Parameters</dt><dd>
289
<table class="params">
290
<tr><td class="paramname">mainInterface</td><td>The proxy to use. </td></tr>
291
<tr><td class="paramname">parent</td><td>Passed to the parent class constructor. </td></tr>
298
<h2 class="groupheader">Member Function Documentation</h2>
299
<a class="anchor" id="a238dae2975d564211a604d8abcc53d99"></a>
300
<div class="memitem">
301
<div class="memproto">
302
<table class="mlabels">
304
<td class="mlabels-left">
305
<table class="memname">
307
<td class="memname">static QLatin1String Tp::Client::ProtocolInterfaceAddressingInterface::staticInterfaceName </td>
309
<td class="paramname"></td><td>)</td>
314
<td class="mlabels-right">
315
<span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">static</span></span> </td>
318
</div><div class="memdoc">
319
<p>Returns the name of the interface "org.freedesktop.Telepathy.Protocol.Interface.Addressing", which this class represents.</p>
320
<dl class="section return"><dt>Returns</dt><dd>The D-Bus interface name. </dd></dl>
324
<a class="anchor" id="a721bca967bc332882ffc976be4a43af6"></a>
325
<div class="memitem">
326
<div class="memproto">
327
<table class="mlabels">
329
<td class="mlabels-left">
330
<table class="memname">
332
<td class="memname"><a class="el" href="a00452.html">Tp::PendingVariant</a>* Tp::Client::ProtocolInterfaceAddressingInterface::requestPropertyAddressableVCardFields </td>
334
<td class="paramname"></td><td>)</td>
339
<td class="mlabels-right">
340
<span class="mlabels"><span class="mlabel">inline</span></span> </td>
343
</div><div class="memdoc">
344
<p>Asynchronous getter for the remote object property <code>AddressableVCardFields</code> of type <code>QStringList</code>.</p>
346
<p>The vCard fields that can be used to request a contact with
347
normalized to lower case. If the <code>URL</code> vCard
348
field is addressable, a colon, followed by the supported URI
349
schemes will be concatenated.</p>
351
<p>For example: <code>["tel", "x-sip"]</code>.</p>
353
<p>The <code>url</code> vCard field MUST NOT appear here; see
354
<a class="el" href="a00470.html#a3164a117332272810ca7f8cc089a219e">AddressableURISchemes </a> instead.</p>
356
<div class="rationale">
357
<p>In practice, protocols have a limited set of URI
358
schemes that make sense to resolve as a contact.</p>
361
<p>Connection managers with a <code>.manager</code> file
362
MUST cache this property in the protocol's section of the
363
<code>.manager</code> file if it is non-empty, using the key
364
<code>AddressableVCardFields</code>. The corresponding value
365
is a list of strings, each followed with a semicolon and in the
366
syntax of the "localestring" type from the Desktop Entry
369
<p>Well-known vCard fields:</p>
372
<dt><code>tel</code></dt>
373
<dd>The TEL vCard field. Used for phone numbers.</dd>
374
<dt><code>x-sip</code></dt>
375
<dd>The X-SIP vCard field. Used for SIP addresses.</dd>
376
<dt><code>x-aim</code></dt>
377
<dd>The X-AIM vCard field. Used for AIM user IDs.</dd>
378
<dt><code>x-icq</code></dt>
379
<dd>The X-ICQ vCard field. Used for ICQ UINs.</dd>
380
<dt><code>x-skype</code></dt>
381
<dd>The X-SKYPE vCard field. Used for Skype user names or
382
telephone numbers. There is also a X-SKYPE-USERNAME field,
383
but for Telepathy purposes, <code>x-skype</code> is preferred</dd>
384
<dt><code>x-groupwise</code></dt>
385
<dd>The X-GROUPWISE vCard field. Used for Groupwise contacts.</dd>
386
<dt><code>x-gadugadu</code></dt>
387
<dd>The X-GADUGADU vCard field. Used for Gadu-Gadu contacts.</dd>
388
<dt><code>x-jabber</code></dt>
389
<dd>The X-JABBER vCard field. Used for XMPP JIDs.</dd>
390
<dt><code>x-msn</code></dt>
391
<dd>The X-MSN vCard field. Used for MSN contacts.</dd>
392
<dt><code>x-yahoo</code></dt>
393
<dd>The X-YAHOO vCard field. Used for Yahoo! IDs.</dd>
394
<dt><code>x-facebook-id</code></dt>
395
<dd>Used for Facebook IDs in XMPP. If the user JID is
396
"-12345@chat.facebook.com" then the x-facebook-id is "12345"</dd>
398
<dl class="section return"><dt>Returns</dt><dd>A pending variant which will emit finished when the property has been retrieved. </dd></dl>
402
<a class="anchor" id="a3164a117332272810ca7f8cc089a219e"></a>
403
<div class="memitem">
404
<div class="memproto">
405
<table class="mlabels">
407
<td class="mlabels-left">
408
<table class="memname">
410
<td class="memname"><a class="el" href="a00452.html">Tp::PendingVariant</a>* Tp::Client::ProtocolInterfaceAddressingInterface::requestPropertyAddressableURISchemes </td>
412
<td class="paramname"></td><td>)</td>
417
<td class="mlabels-right">
418
<span class="mlabels"><span class="mlabel">inline</span></span> </td>
421
</div><div class="memdoc">
422
<p>Asynchronous getter for the remote object property <code>AddressableURISchemes</code> of type <code>QStringList</code>.</p>
424
<p>The URI schemes that are supported by this protocol.</p>
426
<p>For example: <code>["tel", "sip"]</code>.</p>
428
<p>This property should only be used when the connection is
429
offline. When it is connected the addressable URI schemes should be
431
<a class="el" href="a00303.html#a00ada64383785ded487e93cea7f72e44">ConnectionInterfaceRequestsInterface::RequestableChannelClasses </a> 's
432
TargetURIScheme fixed-property instead.</p>
434
<p>Connection managers with a <code>.manager</code> file
435
MUST cache this property in the protocol's section of the
436
<code>.manager</code> file if it is non-empty, using the key
437
<code>AddressableURISchemes</code>. The corresponding value
438
is a list of strings, each followed with a semicolon and in the
439
syntax of the "localestring" type from the Desktop Entry
442
<p>Well-known URI schemes:</p>
445
<dt><code>sip</code></dt>
447
For example: <code>sip:julien@example.com</code>.</dd>
448
<dt><code>sips</code></dt>
449
<dd>Secure (encrypted) SIP protocol.
450
For example: <code>sips:julien@example.com</code>.</dd>
451
<dt><code>tel</code></dt>
452
<dd>Used for telephone numbers.
453
For example: <code>tel:+12065551234</code>.</dd>
454
<dt><code>xmpp</code></dt>
456
For example: <code>xmpp:julien@example.com</code>.</dd>
457
<dt><code>msnim</code></dt>
458
<dd>For the purposes of
459
<a class="el" href="a00470.html">ProtocolInterfaceAddressingInterface</a> ,
460
<a class="el" href="a00269.html">ConnectionInterfaceAddressingInterface</a> ,
462
org.freedesktop.Telepathy.Channel.Interface.Addressing1 ,
463
the verb part is ignored, and SHOULD be <code>add</code>; the
464
<code>contact</code> field in the query string is used to
465
identify the contact.
466
For example: <code>msnim:add?contact=julien</code>.</dd>
467
<dt><code>aim</code></dt>
468
<dd>For the purposes of
469
<a class="el" href="a00470.html">ProtocolInterfaceAddressingInterface</a> ,
470
<a class="el" href="a00269.html">ConnectionInterfaceAddressingInterface</a> ,
472
org.freedesktop.Telepathy.Channel.Interface.Addressing1 ,
473
the verb part is ignored, and SHOULD be <code>addbuddy</code>; the
474
<code>screenname</code> field in the query string is used to
475
identify the contact.
476
For example: <code>aim:addbuddy?screenname=julien</code>.</dd>
477
<dt><code>skype</code></dt>
479
For example: <code>skype:julien</code>.</dd>
480
<dt><code>ymsgr</code></dt>
481
<dd>For the purposes of
482
<a class="el" href="a00470.html">ProtocolInterfaceAddressingInterface</a> ,
483
<a class="el" href="a00269.html">ConnectionInterfaceAddressingInterface</a> ,
485
org.freedesktop.Telepathy.Channel.Interface.Addressing1 ,
486
the verb part is ignored, and SHOULD be <code>addfriend</code>; the
487
query string is used to identify the contact.
488
For example: <code>ymsgr:addfriend?julien</code>.</dd>
489
<dt><code>gg</code></dt>
490
<dd>Gadu-Gadu protocol.
491
For example: <code>gg:julien</code>.</dd>
493
<dl class="section return"><dt>Returns</dt><dd>A pending variant which will emit finished when the property has been retrieved. </dd></dl>
497
<a class="anchor" id="a238777bf0c352ab646890749a744acb5"></a>
498
<div class="memitem">
499
<div class="memproto">
500
<table class="mlabels">
502
<td class="mlabels-left">
503
<table class="memname">
505
<td class="memname"><a class="el" href="a00453.html">Tp::PendingVariantMap</a>* Tp::Client::ProtocolInterfaceAddressingInterface::requestAllProperties </td>
507
<td class="paramname"></td><td>)</td>
512
<td class="mlabels-right">
513
<span class="mlabels"><span class="mlabel">inline</span></span> </td>
516
</div><div class="memdoc">
517
<p>Request all of the <a class="el" href="a00865.html">DBus</a> properties on the interface.</p>
518
<dl class="section return"><dt>Returns</dt><dd>A pending variant map which will emit finished when the properties have been retrieved. </dd></dl>
522
<a class="anchor" id="a7e5d861026881f3a8166ffff910e06d3"></a>
523
<div class="memitem">
524
<div class="memproto">
525
<table class="mlabels">
527
<td class="mlabels-left">
528
<table class="memname">
530
<td class="memname">QDBusPendingReply<QString> Tp::Client::ProtocolInterfaceAddressingInterface::NormalizeVCardAddress </td>
532
<td class="paramtype">const QString & </td>
533
<td class="paramname"><em>VCardField</em>, </td>
536
<td class="paramkey"></td>
538
<td class="paramtype">const QString & </td>
539
<td class="paramname"><em>VCardAddress</em>, </td>
542
<td class="paramkey"></td>
544
<td class="paramtype">int </td>
545
<td class="paramname"><em>timeout</em> = <code>-1</code> </td>
554
<td class="mlabels-right">
555
<span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">slot</span></span> </td>
558
</div><div class="memdoc">
559
<p>Begins a call to the D-Bus method <code>NormalizeVCardAddress</code> on the remote object.</p>
561
<p>Attempt to normalize the given vCard address. Where possible, this
562
SHOULD return an address that would appear in the
563
<code>org.freedesktop.Telepathy.Connection.Interface.Addressing1/addresses</code>
564
attribute for a contact on a connected
565
<a class="el" href="a00267.html">ConnectionInterface</a> .
568
<p>If full normalization requires network activity or is otherwise
569
impossible to do without a <a class="el" href="a00267.html">ConnectionInterface</a> ,
570
this method SHOULD perform a best-effort normalization.</p>
572
<p>An example would be a vCard TEL field with a formatted
573
number in the form of <code>+1 (206) 555 1234</code>, this would be
574
normalized to <code>+12065551234</code>.</p>
576
<p>This method MAY simply raise NotImplemented on some
577
protocols, if it has no use.</p>
578
<p>Note that <em>timeout</em> is ignored as of now. It will be used once <a href="http://bugreports.qt.nokia.com/browse/QTBUG-11775">http://bugreports.qt.nokia.com/browse/QTBUG-11775</a> is fixed.</p>
579
<dl class="params"><dt>Parameters</dt><dd>
580
<table class="params">
581
<tr><td class="paramname">VCardField</td><td><pre class="fragment">The vCard field of the address we are normalizing. The field name
582
SHOULD be in lower case, and MUST appear in AddressableVCardFields.
584
<tr><td class="paramname">VCardAddress</td><td><pre class="fragment">The address to normalize, which is assumed to belong to a contact
585
(and not, for instance, a chatroom or server).
587
<tr><td class="paramname">timeout</td><td>The timeout in milliseconds.</td></tr>
591
<dl class="section return"><dt>Returns</dt><dd><pre class="fragment">The vCard address, normalized as much as possible.</pre> </dd></dl>
595
<a class="anchor" id="a79088c750137c2a24449c963899252cd"></a>
596
<div class="memitem">
597
<div class="memproto">
598
<table class="mlabels">
600
<td class="mlabels-left">
601
<table class="memname">
603
<td class="memname">QDBusPendingReply<QString> Tp::Client::ProtocolInterfaceAddressingInterface::NormalizeContactURI </td>
605
<td class="paramtype">const QString & </td>
606
<td class="paramname"><em>URI</em>, </td>
609
<td class="paramkey"></td>
611
<td class="paramtype">int </td>
612
<td class="paramname"><em>timeout</em> = <code>-1</code> </td>
621
<td class="mlabels-right">
622
<span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">slot</span></span> </td>
625
</div><div class="memdoc">
626
<p>Begins a call to the D-Bus method <code>NormalizeContactURI</code> on the remote object.</p>
628
<p>Attempt to normalize the given contact URI. Where possible, this
629
SHOULD return an address that would appear in the
630
<code>org.freedesktop.Telepathy.Connection.Interface.Addressing1/uris</code>
631
attribute for a contact on a connected
632
<a class="el" href="a00267.html">ConnectionInterface</a> .
635
<p>If full normalization requires network activity or is otherwise
636
impossible to do without a <a class="el" href="a00267.html">ConnectionInterface</a> ,
637
this method SHOULD perform a best-effort normalization.</p>
639
<p>If the URI has extra information beyond what's necessary to
640
identify a particular contact, such as an XMPP resource or an
641
action to carry out, this extra information SHOULD be removed.
642
If all URIs in a scheme contain a verb or action
643
(like <code>aim</code>, <code>ymsgr</code> and
644
<code>msnim</code> URIs), then the verb SHOULD be replaced
645
with the one specified in
646
<a class="el" href="a00470.html#a3164a117332272810ca7f8cc089a219e">AddressableURISchemes </a> .</p>
648
<div class="rationale">
649
<p>This method is intended to normalize URIs stored in address
650
books, for instance. In protocols like XMPP, if you
651
vary the resource or action (query string), the URI still
652
refers to the same high-level contact.</p>
656
<code>xmpp:romeo@Example.Com/Empathy?message;body=Hello</code>
657
would be normalized to <code>xmpp:romeo@example.com</code>,
658
and <code>aim:goim?screenname=Romeo%20M&message=Hello</code>
659
would be normalized to
660
<code>aim:addbuddy?screenname=romeom</code>.</p>
662
<p>This method MAY simply raise NotImplemented on some
663
protocols, if it has no use.</p>
664
<p>Note that <em>timeout</em> is ignored as of now. It will be used once <a href="http://bugreports.qt.nokia.com/browse/QTBUG-11775">http://bugreports.qt.nokia.com/browse/QTBUG-11775</a> is fixed.</p>
665
<dl class="params"><dt>Parameters</dt><dd>
666
<table class="params">
667
<tr><td class="paramname">URI</td><td><pre class="fragment">The URI to normalize, which is assumed to refer to a contact (as
668
opposed to, for instance, a chatroom or a server). In some
669
protocols, like XMPP, there is no way to tell whether a given URI
670
refers to a contact or a chatroom by looking at its syntax. The
671
URI&apos;s scheme (i.e. the part before the first colon) MUST
672
appear in AddressableURISchemes.
674
<tr><td class="paramname">timeout</td><td>The timeout in milliseconds.</td></tr>
678
<dl class="section return"><dt>Returns</dt><dd><pre class="fragment">A URI, normalized as much as possible.</pre> </dd></dl>
682
<a class="anchor" id="a2e2fb91a802acb07243e857da962ac34"></a>
683
<div class="memitem">
684
<div class="memproto">
685
<table class="mlabels">
687
<td class="mlabels-left">
688
<table class="memname">
690
<td class="memname">void Tp::Client::ProtocolInterfaceAddressingInterface::invalidate </td>
692
<td class="paramtype"><a class="el" href="a00339.html">Tp::DBusProxy</a> * </td>
693
<td class="paramname"><em>proxy</em>, </td>
696
<td class="paramkey"></td>
698
<td class="paramtype">const QString & </td>
699
<td class="paramname"><em>error</em>, </td>
702
<td class="paramkey"></td>
704
<td class="paramtype">const QString & </td>
705
<td class="paramname"><em>message</em> </td>
714
<td class="mlabels-right">
715
<span class="mlabels"><span class="mlabel">protected</span><span class="mlabel">virtual</span></span> </td>
718
</div><div class="memdoc">
720
<p>Reimplemented from <a class="el" href="a00070.html#a79dde56ba44455f47c7c354ada07467a">Tp::AbstractInterface</a>.</p>
724
</div><!-- contents -->
725
<p /><address><hr /><div align="center">
726
<table width="100%" cellspacing="0" border="0"><tr class="address">
727
<td width="30%">Copyright © 2008-2011 Collabora Ltd. and Nokia Corporation</td>
728
<td width="30%" align="right"><div align="right">Telepathy-Qt 0.9.6.1</div></td>
729
</tr></table></div></address>
added
removed
doc/html/a00470.html
