29
<!-- Generated by Doxygen 1.7.6.1 -->
30
<div id="nav-path" class="navpath">
32
<li class="navelem"><a class="el" href="a00724.html">Tp</a> </li>
33
<li class="navelem"><a class="el" href="a00728.html">Client</a> </li>
34
<li class="navelem"><a class="el" href="a00184.html">ConnectionInterfaceServicePointInterface</a> </li>
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="a00184.html">ChannelInterface</a></li> </ul>
38
35
<div class="header">
39
36
<div class="summary">
37
<a href="#pub-slots">Public Slots</a> |
40
38
<a href="#signals">Signals</a> |
41
39
<a href="#pub-methods">Public Member Functions</a> |
42
40
<a href="#pub-static-methods">Static Public Member Functions</a> |
43
<a href="#pro-methods">Protected Member Functions</a> </div>
41
<a href="#pro-methods">Protected Member Functions</a> |
42
<a href="a01252.html">List of all members</a> </div>
44
43
<div class="headertitle">
45
<div class="title">Tp::Client::ConnectionInterfaceServicePointInterface Class Reference<div class="ingroups"><a class="el" href="a00745.html">Connection proxies</a></div></div> </div>
44
<div class="title">Tp::Client::ChannelInterface Class Reference<div class="ingroups"><a class="el" href="a00876.html">Channel proxies</a></div></div> </div>
46
45
</div><!--header-->
47
46
<div class="contents">
48
<!-- doxytag: class="Tp::Client::ConnectionInterfaceServicePointInterface" --><!-- doxytag: inherits="Tp::AbstractInterface" -->
49
<p><code>#include <<a class="el" href="a00508_source.html">TelepathyQt/Connection</a>></code></p>
51
<p>Inherits <a class="el" href="a00037.html">Tp::AbstractInterface</a>.</p>
53
<p><a href="a01142.html">List of all members.</a></p>
54
<h2><a name="signals"></a>
57
<li>void <a class="el" href="a00184.html#a9656242d774513124acafbe3b7f96e25">ServicePointsChanged</a> (const <a class="el" href="a00761.html#ga1f268bf6d2790e4364cf6fe8b8b66ba5">Tp::ServicePointInfoList</a> &servicePoints)
59
<h2><a name="pub-methods"></a>
60
Public Member Functions</h2>
62
<li><a class="el" href="a00184.html#aa23b82c27507a86de530f384adc545e1">ConnectionInterfaceServicePointInterface</a> (const QString &busName, const QString &objectPath, QObject *parent=0)
63
<li><a class="el" href="a00184.html#a5fd775577c9bfc10ae49365b047aedf7">ConnectionInterfaceServicePointInterface</a> (const QDBusConnection &connection, const QString &busName, const QString &objectPath, QObject *parent=0)
64
<li><a class="el" href="a00184.html#ae328508880e3740aeeddf74e4bd7c169">ConnectionInterfaceServicePointInterface</a> (<a class="el" href="a00216.html">Tp::DBusProxy</a> *proxy)
65
<li><a class="el" href="a00184.html#a826306f29e572bebe538afd9ff96b0a8">ConnectionInterfaceServicePointInterface</a> (const <a class="el" href="a00164.html">Tp::Client::ConnectionInterface</a> &mainInterface)
66
<li><a class="el" href="a00184.html#a59aa84a66389ecee41ca3015031b6030">ConnectionInterfaceServicePointInterface</a> (const <a class="el" href="a00164.html">Tp::Client::ConnectionInterface</a> &mainInterface, QObject *parent)
67
<li><a class="el" href="a00329.html">Tp::PendingVariant</a> * <a class="el" href="a00184.html#a9e12a38a30383d79b8510603d2d706db">requestPropertyKnownServicePoints</a> () const
68
<li><a class="el" href="a00330.html">Tp::PendingVariantMap</a> * <a class="el" href="a00184.html#a6e73acb7b1c549076fb7aaa49494dd21">requestAllProperties</a> () const
70
<h2><a name="pub-static-methods"></a>
71
Static Public Member Functions</h2>
73
<li>static QLatin1String <a class="el" href="a00184.html#ac8a1be985e3a6a12590d1f00bfc6e548">staticInterfaceName</a> ()
75
<h2><a name="pro-methods"></a>
76
Protected Member Functions</h2>
78
<li>virtual void <a class="el" href="a00184.html#a14b11f7cb8796fb3374e6a3ae001a8ff">invalidate</a> (<a class="el" href="a00216.html">Tp::DBusProxy</a> *, const QString &, const QString &)
80
<hr/><a name="details" id="details"></a><h2>Detailed Description</h2>
81
<div class="textblock"><p>Proxy class providing a 1:1 mapping of the D-Bus interface "org.freedesktop.Telepathy.Connection.Interface.ServicePoint". </p>
82
</div><hr/><h2>Constructor & Destructor Documentation</h2>
83
<a class="anchor" id="aa23b82c27507a86de530f384adc545e1"></a><!-- doxytag: member="Tp::Client::ConnectionInterfaceServicePointInterface::ConnectionInterfaceServicePointInterface" ref="aa23b82c27507a86de530f384adc545e1" args="(const QString &busName, const QString &objectPath, QObject *parent=0)" -->
48
<p><code>#include <<a class="el" href="a00631_source.html">TelepathyQt/Channel</a>></code></p>
50
<p>Inherits <a class="el" href="a00070.html">Tp::AbstractInterface</a>.</p>
51
<table class="memberdecls">
52
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="pub-slots"></a>
53
Public Slots</h2></td></tr>
54
<tr class="memitem:a822439bf7adb2ce890cf8066ea01a1ff"><td class="memItemLeft" align="right" valign="top">QDBusPendingReply </td><td class="memItemRight" valign="bottom"><a class="el" href="a00184.html#a822439bf7adb2ce890cf8066ea01a1ff">Close</a> (int timeout=-1)</td></tr>
55
<tr class="separator:a822439bf7adb2ce890cf8066ea01a1ff"><td class="memSeparator" colspan="2"> </td></tr>
56
<tr class="memitem:aa14a76049f40ba119845f2c52f84bdeb"><td class="memItemLeft" align="right" valign="top">QDBusPendingReply< QString > </td><td class="memItemRight" valign="bottom"><a class="el" href="a00184.html#aa14a76049f40ba119845f2c52f84bdeb">GetChannelType</a> (int timeout=-1)</td></tr>
57
<tr class="separator:aa14a76049f40ba119845f2c52f84bdeb"><td class="memSeparator" colspan="2"> </td></tr>
58
<tr class="memitem:a135d5199c69e92039f81bcbad48d6e27"><td class="memItemLeft" align="right" valign="top">QDBusPendingReply< uint, uint > </td><td class="memItemRight" valign="bottom"><a class="el" href="a00184.html#a135d5199c69e92039f81bcbad48d6e27">GetHandle</a> (int timeout=-1)</td></tr>
59
<tr class="separator:a135d5199c69e92039f81bcbad48d6e27"><td class="memSeparator" colspan="2"> </td></tr>
60
<tr class="memitem:a65855cac589751eee7717e266caa7c6c"><td class="memItemLeft" align="right" valign="top">QDBusPendingReply< QStringList > </td><td class="memItemRight" valign="bottom"><a class="el" href="a00184.html#a65855cac589751eee7717e266caa7c6c">GetInterfaces</a> (int timeout=-1)</td></tr>
61
<tr class="separator:a65855cac589751eee7717e266caa7c6c"><td class="memSeparator" colspan="2"> </td></tr>
62
</table><table class="memberdecls">
63
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="signals"></a>
64
Signals</h2></td></tr>
65
<tr class="memitem:a42005b6ea5c4fb962a2a8789a35741da"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="a00184.html#a42005b6ea5c4fb962a2a8789a35741da">Closed</a> ()</td></tr>
66
<tr class="separator:a42005b6ea5c4fb962a2a8789a35741da"><td class="memSeparator" colspan="2"> </td></tr>
67
<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>
68
<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>
69
<tr class="separator:a1c7549c77596f07f241e361c5124119d inherit signals_a00070"><td class="memSeparator" colspan="2"> </td></tr>
70
</table><table class="memberdecls">
71
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="pub-methods"></a>
72
Public Member Functions</h2></td></tr>
73
<tr class="memitem:a892880ace6b153f8c4cb6bd19066c074"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="a00184.html#a892880ace6b153f8c4cb6bd19066c074">ChannelInterface</a> (const QString &busName, const QString &objectPath, QObject *parent=0)</td></tr>
74
<tr class="separator:a892880ace6b153f8c4cb6bd19066c074"><td class="memSeparator" colspan="2"> </td></tr>
75
<tr class="memitem:a9044ef5ba0d6848c83511ab1d53d9c56"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="a00184.html#a9044ef5ba0d6848c83511ab1d53d9c56">ChannelInterface</a> (const QDBusConnection &connection, const QString &busName, const QString &objectPath, QObject *parent=0)</td></tr>
76
<tr class="separator:a9044ef5ba0d6848c83511ab1d53d9c56"><td class="memSeparator" colspan="2"> </td></tr>
77
<tr class="memitem:a248dd4161960529ca31f7cca130cbe36"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="a00184.html#a248dd4161960529ca31f7cca130cbe36">ChannelInterface</a> (<a class="el" href="a00339.html">Tp::DBusProxy</a> *proxy)</td></tr>
78
<tr class="separator:a248dd4161960529ca31f7cca130cbe36"><td class="memSeparator" colspan="2"> </td></tr>
79
<tr class="memitem:a48df5dad17fa70262c8d59b2c75c83c2"><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="a00184.html#a48df5dad17fa70262c8d59b2c75c83c2">requestPropertyChannelType</a> () const </td></tr>
80
<tr class="separator:a48df5dad17fa70262c8d59b2c75c83c2"><td class="memSeparator" colspan="2"> </td></tr>
81
<tr class="memitem:ac0ef159d0249fe8fe9faf1b6a5dbba99"><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="a00184.html#ac0ef159d0249fe8fe9faf1b6a5dbba99">requestPropertyInterfaces</a> () const </td></tr>
82
<tr class="separator:ac0ef159d0249fe8fe9faf1b6a5dbba99"><td class="memSeparator" colspan="2"> </td></tr>
83
<tr class="memitem:aba93f0a84612cc6c2adf866eaff3e763"><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="a00184.html#aba93f0a84612cc6c2adf866eaff3e763">requestPropertyTargetHandle</a> () const </td></tr>
84
<tr class="separator:aba93f0a84612cc6c2adf866eaff3e763"><td class="memSeparator" colspan="2"> </td></tr>
85
<tr class="memitem:aa04a1d3032316883c6ce5085f20caf68"><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="a00184.html#aa04a1d3032316883c6ce5085f20caf68">requestPropertyTargetID</a> () const </td></tr>
86
<tr class="separator:aa04a1d3032316883c6ce5085f20caf68"><td class="memSeparator" colspan="2"> </td></tr>
87
<tr class="memitem:a389f3d423b4da14c328fd0ddbe20b8ae"><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="a00184.html#a389f3d423b4da14c328fd0ddbe20b8ae">requestPropertyTargetHandleType</a> () const </td></tr>
88
<tr class="separator:a389f3d423b4da14c328fd0ddbe20b8ae"><td class="memSeparator" colspan="2"> </td></tr>
89
<tr class="memitem:a32516a093708b2b8accc930b8252dcfa"><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="a00184.html#a32516a093708b2b8accc930b8252dcfa">requestPropertyRequested</a> () const </td></tr>
90
<tr class="separator:a32516a093708b2b8accc930b8252dcfa"><td class="memSeparator" colspan="2"> </td></tr>
91
<tr class="memitem:a88f912db7a4d0680d3d78d928369cbe7"><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="a00184.html#a88f912db7a4d0680d3d78d928369cbe7">requestPropertyInitiatorHandle</a> () const </td></tr>
92
<tr class="separator:a88f912db7a4d0680d3d78d928369cbe7"><td class="memSeparator" colspan="2"> </td></tr>
93
<tr class="memitem:af7de86e324a198e115d6957f3da83fa1"><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="a00184.html#af7de86e324a198e115d6957f3da83fa1">requestPropertyInitiatorID</a> () const </td></tr>
94
<tr class="separator:af7de86e324a198e115d6957f3da83fa1"><td class="memSeparator" colspan="2"> </td></tr>
95
<tr class="memitem:afedf34d3aac0c21bd9f6c49cc2709472"><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="a00184.html#afedf34d3aac0c21bd9f6c49cc2709472">requestAllProperties</a> () const </td></tr>
96
<tr class="separator:afedf34d3aac0c21bd9f6c49cc2709472"><td class="memSeparator" colspan="2"> </td></tr>
97
<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>
98
<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>
99
<tr class="separator:ad82f1079204bca0dcfd1f6eeda3b0bcf inherit pub_methods_a00070"><td class="memSeparator" colspan="2"> </td></tr>
100
<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>
101
<tr class="separator:a6ffad807cd688510af39c9ddd808d5b5 inherit pub_methods_a00070"><td class="memSeparator" colspan="2"> </td></tr>
102
<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>
103
<tr class="separator:a8bf99ab34d551325914c08500acadc94 inherit pub_methods_a00070"><td class="memSeparator" colspan="2"> </td></tr>
104
<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>
105
<tr class="separator:a96caf6bfea37a71d4849b4470728ceb4 inherit pub_methods_a00070"><td class="memSeparator" colspan="2"> </td></tr>
106
<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>
107
<tr class="separator:a6b4af7363d43822a32fdd3fa56108424 inherit pub_methods_a00070"><td class="memSeparator" colspan="2"> </td></tr>
108
<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>
109
<tr class="separator:a3714c9535fdd183a175c1b1e668f4ec7 inherit pub_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="pub-static-methods"></a>
112
Static Public Member Functions</h2></td></tr>
113
<tr class="memitem:ae7005466f857a3b9117b4c191e3ef65e"><td class="memItemLeft" align="right" valign="top">static QLatin1String </td><td class="memItemRight" valign="bottom"><a class="el" href="a00184.html#ae7005466f857a3b9117b4c191e3ef65e">staticInterfaceName</a> ()</td></tr>
114
<tr class="separator:ae7005466f857a3b9117b4c191e3ef65e"><td class="memSeparator" colspan="2"> </td></tr>
115
</table><table class="memberdecls">
116
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="pro-methods"></a>
117
Protected Member Functions</h2></td></tr>
118
<tr class="memitem:a0a29ac5a212f2e0b0e9db5544d245ee1"><td class="memItemLeft" align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><a class="el" href="a00184.html#a0a29ac5a212f2e0b0e9db5544d245ee1">invalidate</a> (<a class="el" href="a00339.html">Tp::DBusProxy</a> *, const QString &, const QString &)</td></tr>
119
<tr class="separator:a0a29ac5a212f2e0b0e9db5544d245ee1"><td class="memSeparator" colspan="2"> </td></tr>
120
<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>
121
<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>
122
<tr class="separator:ae73665dbe1abf1c50a8ab98221274dbe inherit pro_methods_a00070"><td class="memSeparator" colspan="2"> </td></tr>
123
<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>
124
<tr class="separator:a454ff620101be4299892b3e47fead4d2 inherit pro_methods_a00070"><td class="memSeparator" colspan="2"> </td></tr>
125
<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>
126
<tr class="separator:ad97c6346a1c2bbfd893943d60da27b89 inherit pro_methods_a00070"><td class="memSeparator" colspan="2"> </td></tr>
127
<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>
128
<tr class="separator:a735ab438b3675c6938cd534722c47b4e inherit pro_methods_a00070"><td class="memSeparator" colspan="2"> </td></tr>
129
<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>
130
<tr class="separator:a0fe684d0ef843a3e36f2ecee24defed6 inherit pro_methods_a00070"><td class="memSeparator" colspan="2"> </td></tr>
131
</table><table class="memberdecls">
132
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="inherited"></a>
133
Additional Inherited Members</h2></td></tr>
134
<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>
136
<a name="details" id="details"></a><h2 class="groupheader">Detailed Description</h2>
137
<div class="textblock"><p>Proxy class providing a 1:1 mapping of the D-Bus interface "org.freedesktop.Telepathy.Channel". </p>
138
</div><h2 class="groupheader">Constructor & Destructor Documentation</h2>
139
<a class="anchor" id="a892880ace6b153f8c4cb6bd19066c074"></a>
84
140
<div class="memitem">
85
141
<div class="memproto">
86
142
<table class="memname">
88
<td class="memname"><a class="el" href="a00184.html#aa23b82c27507a86de530f384adc545e1">Tp::Client::ConnectionInterfaceServicePointInterface::ConnectionInterfaceServicePointInterface</a> </td>
144
<td class="memname">Tp::Client::ChannelInterface::ChannelInterface </td>
90
146
<td class="paramtype">const QString & </td>
91
147
<td class="paramname"><em>busName</em>, </td>
198
<a class="anchor" id="a826306f29e572bebe538afd9ff96b0a8"></a><!-- doxytag: member="Tp::Client::ConnectionInterfaceServicePointInterface::ConnectionInterfaceServicePointInterface" ref="a826306f29e572bebe538afd9ff96b0a8" args="(const Tp::Client::ConnectionInterface &mainInterface)" -->
199
<div class="memitem">
200
<div class="memproto">
201
<table class="memname">
203
<td class="memname"><a class="el" href="a00184.html#aa23b82c27507a86de530f384adc545e1">Tp::Client::ConnectionInterfaceServicePointInterface::ConnectionInterfaceServicePointInterface</a> </td>
205
<td class="paramtype">const <a class="el" href="a00164.html">Tp::Client::ConnectionInterface</a> & </td>
206
<td class="paramname"><em>mainInterface</em></td><td>)</td>
207
<td><code> [explicit]</code></td>
212
<p>Creates a <a class="el" href="a00184.html">ConnectionInterfaceServicePointInterface</a> associated with the same object as the given proxy. Additionally, the created proxy will have the same parent as the given proxy.</p>
213
<dl class="params"><dt><b>Parameters:</b></dt><dd>
214
<table class="params">
215
<tr><td class="paramname">mainInterface</td><td>The proxy to use. </td></tr>
222
<a class="anchor" id="a59aa84a66389ecee41ca3015031b6030"></a><!-- doxytag: member="Tp::Client::ConnectionInterfaceServicePointInterface::ConnectionInterfaceServicePointInterface" ref="a59aa84a66389ecee41ca3015031b6030" args="(const Tp::Client::ConnectionInterface &mainInterface, QObject *parent)" -->
223
<div class="memitem">
224
<div class="memproto">
225
<table class="memname">
227
<td class="memname"><a class="el" href="a00184.html#aa23b82c27507a86de530f384adc545e1">Tp::Client::ConnectionInterfaceServicePointInterface::ConnectionInterfaceServicePointInterface</a> </td>
229
<td class="paramtype">const <a class="el" href="a00164.html">Tp::Client::ConnectionInterface</a> & </td>
230
<td class="paramname"><em>mainInterface</em>, </td>
233
<td class="paramkey"></td>
235
<td class="paramtype">QObject * </td>
236
<td class="paramname"><em>parent</em> </td>
246
<p>Creates a <a class="el" href="a00184.html">ConnectionInterfaceServicePointInterface</a> associated with the same object as the given proxy. However, a different parent object can be specified.</p>
247
<dl class="params"><dt><b>Parameters:</b></dt><dd>
248
<table class="params">
249
<tr><td class="paramname">mainInterface</td><td>The proxy to use. </td></tr>
250
<tr><td class="paramname">parent</td><td>Passed to the parent class constructor. </td></tr>
257
<hr/><h2>Member Function Documentation</h2>
258
<a class="anchor" id="ac8a1be985e3a6a12590d1f00bfc6e548"></a><!-- doxytag: member="Tp::Client::ConnectionInterfaceServicePointInterface::staticInterfaceName" ref="ac8a1be985e3a6a12590d1f00bfc6e548" args="()" -->
259
<div class="memitem">
260
<div class="memproto">
261
<table class="memname">
263
<td class="memname">static QLatin1String <a class="el" href="a00184.html#ac8a1be985e3a6a12590d1f00bfc6e548">Tp::Client::ConnectionInterfaceServicePointInterface::staticInterfaceName</a> </td>
265
<td class="paramname"></td><td>)</td>
266
<td><code> [inline, static]</code></td>
271
<p>Returns the name of the interface "org.freedesktop.Telepathy.Connection.Interface.ServicePoint", which this class represents.</p>
272
<dl class="return"><dt><b>Returns:</b></dt><dd>The D-Bus interface name. </dd></dl>
276
<a class="anchor" id="a9e12a38a30383d79b8510603d2d706db"></a><!-- doxytag: member="Tp::Client::ConnectionInterfaceServicePointInterface::requestPropertyKnownServicePoints" ref="a9e12a38a30383d79b8510603d2d706db" args="() const " -->
277
<div class="memitem">
278
<div class="memproto">
279
<table class="memname">
281
<td class="memname"><a class="el" href="a00329.html">Tp::PendingVariant</a>* <a class="el" href="a00184.html#a9e12a38a30383d79b8510603d2d706db">Tp::Client::ConnectionInterfaceServicePointInterface::requestPropertyKnownServicePoints</a> </td>
283
<td class="paramname"></td><td>)</td>
284
<td> const<code> [inline]</code></td>
289
<p>Asynchronous getter for the remote object property <code>KnownServicePoints</code> of type <code><a class="el" href="a00761.html#ga1f268bf6d2790e4364cf6fe8b8b66ba5">Tp::ServicePointInfoList</a></code>.</p>
291
The list of all (known) service points.
292
<dl class="return"><dt><b>Returns:</b></dt><dd>A pending variant which will emit finished when the property has been retrieved. </dd></dl>
296
<a class="anchor" id="a6e73acb7b1c549076fb7aaa49494dd21"></a><!-- doxytag: member="Tp::Client::ConnectionInterfaceServicePointInterface::requestAllProperties" ref="a6e73acb7b1c549076fb7aaa49494dd21" args="() const " -->
297
<div class="memitem">
298
<div class="memproto">
299
<table class="memname">
301
<td class="memname"><a class="el" href="a00330.html">Tp::PendingVariantMap</a>* <a class="el" href="a00184.html#a6e73acb7b1c549076fb7aaa49494dd21">Tp::Client::ConnectionInterfaceServicePointInterface::requestAllProperties</a> </td>
303
<td class="paramname"></td><td>)</td>
304
<td> const<code> [inline]</code></td>
309
<p>Request all of the <a class="el" href="a00729.html">DBus</a> properties on the interface.</p>
310
<dl class="return"><dt><b>Returns:</b></dt><dd>A pending variant map which will emit finished when the properties have been retrieved. </dd></dl>
314
<a class="anchor" id="a9656242d774513124acafbe3b7f96e25"></a><!-- doxytag: member="Tp::Client::ConnectionInterfaceServicePointInterface::ServicePointsChanged" ref="a9656242d774513124acafbe3b7f96e25" args="(const Tp::ServicePointInfoList &servicePoints)" -->
315
<div class="memitem">
316
<div class="memproto">
317
<table class="memname">
319
<td class="memname">void <a class="el" href="a00184.html#a9656242d774513124acafbe3b7f96e25">Tp::Client::ConnectionInterfaceServicePointInterface::ServicePointsChanged</a> </td>
321
<td class="paramtype">const <a class="el" href="a00761.html#ga1f268bf6d2790e4364cf6fe8b8b66ba5">Tp::ServicePointInfoList</a> & </td>
322
<td class="paramname"><em>servicePoints</em></td><td>)</td>
323
<td><code> [signal]</code></td>
328
<p>Represents the signal <code>ServicePointsChanged</code> on the remote object.</p>
329
<p>Emitted when the list of known service points (or their IDs) has changed.</p>
330
<dl class="params"><dt><b>Parameters:</b></dt><dd>
331
<table class="params">
332
<tr><td class="paramname">servicePoints</td><td>
334
<a class="el" href="a00184.html#a9e12a38a30383d79b8510603d2d706db">KnownServicePoints </a> .</p>
342
<a class="anchor" id="a14b11f7cb8796fb3374e6a3ae001a8ff"></a><!-- doxytag: member="Tp::Client::ConnectionInterfaceServicePointInterface::invalidate" ref="a14b11f7cb8796fb3374e6a3ae001a8ff" args="(Tp::DBusProxy *, const QString &, const QString &)" -->
343
<div class="memitem">
344
<div class="memproto">
345
<table class="memname">
347
<td class="memname">void <a class="el" href="a00184.html#a14b11f7cb8796fb3374e6a3ae001a8ff">Tp::Client::ConnectionInterfaceServicePointInterface::invalidate</a> </td>
349
<td class="paramtype"><a class="el" href="a00216.html">Tp::DBusProxy</a> * </td>
251
<h2 class="groupheader">Member Function Documentation</h2>
252
<a class="anchor" id="ae7005466f857a3b9117b4c191e3ef65e"></a>
253
<div class="memitem">
254
<div class="memproto">
255
<table class="mlabels">
257
<td class="mlabels-left">
258
<table class="memname">
260
<td class="memname">static QLatin1String Tp::Client::ChannelInterface::staticInterfaceName </td>
262
<td class="paramname"></td><td>)</td>
267
<td class="mlabels-right">
268
<span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">static</span></span> </td>
271
</div><div class="memdoc">
272
<p>Returns the name of the interface "org.freedesktop.Telepathy.Channel", which this class represents.</p>
273
<dl class="section return"><dt>Returns</dt><dd>The D-Bus interface name. </dd></dl>
277
<a class="anchor" id="a48df5dad17fa70262c8d59b2c75c83c2"></a>
278
<div class="memitem">
279
<div class="memproto">
280
<table class="mlabels">
282
<td class="mlabels-left">
283
<table class="memname">
285
<td class="memname"><a class="el" href="a00452.html">Tp::PendingVariant</a>* Tp::Client::ChannelInterface::requestPropertyChannelType </td>
287
<td class="paramname"></td><td>)</td>
292
<td class="mlabels-right">
293
<span class="mlabels"><span class="mlabel">inline</span></span> </td>
296
</div><div class="memdoc">
297
<p>Asynchronous getter for the remote object property <code>ChannelType</code> of type <code>QString</code>.</p>
299
<p>The channel's type. This cannot change once the channel has
302
<p>For compatibility between older connection managers and newer
303
clients, if this is unavailable or is an empty string,
304
clients MUST use the result of calling
305
<a class="el" href="a00184.html#aa14a76049f40ba119845f2c52f84bdeb">GetChannelType()</a> .</p>
307
<div class="rationale">
308
The GetAll method lets clients retrieve all properties in one
309
round-trip, which is desirable.
312
<p>When requesting a channel, the request MUST specify a channel
313
type, and the request MUST fail if the specified channel type
314
cannot be supplied.</p>
316
<div class="rationale">
319
<dl class="section return"><dt>Returns</dt><dd>A pending variant which will emit finished when the property has been retrieved. </dd></dl>
323
<a class="anchor" id="ac0ef159d0249fe8fe9faf1b6a5dbba99"></a>
324
<div class="memitem">
325
<div class="memproto">
326
<table class="mlabels">
328
<td class="mlabels-left">
329
<table class="memname">
331
<td class="memname"><a class="el" href="a00452.html">Tp::PendingVariant</a>* Tp::Client::ChannelInterface::requestPropertyInterfaces </td>
333
<td class="paramname"></td><td>)</td>
338
<td class="mlabels-right">
339
<span class="mlabels"><span class="mlabel">inline</span></span> </td>
342
</div><div class="memdoc">
343
<p>Asynchronous getter for the remote object property <code>Interfaces</code> of type <code>QStringList</code>.</p>
345
<p>Extra interfaces provided by this channel. This SHOULD NOT include
346
the channel type and the Channel interface itself, and cannot
347
change once the channel has been created.</p>
349
<p>For compatibility between older connection managers and newer
350
clients, if this is unavailable, or if this is an empty list and
351
<a class="el" href="a00184.html#a48df5dad17fa70262c8d59b2c75c83c2">ChannelType </a> is an empty string,
352
clients MUST use the result of calling
353
<a class="el" href="a00184.html#a65855cac589751eee7717e266caa7c6c">GetInterfaces()</a> instead. If this is an
354
empty list but ChannelType is non-empty, clients SHOULD NOT call
355
GetInterfaces; this implies that connection managers that implement
356
the ChannelType property MUST also implement the Interfaces property
359
<div class="rationale">
360
The GetAll method lets clients retrieve all properties in one
361
round-trip, which is desirable.
364
<p>When requesting a channel with a particular value for this
365
property, the request must fail without side-effects unless the
366
connection manager expects to be able to provide a channel whose
367
interfaces include at least the interfaces requested.</p>
368
<dl class="section return"><dt>Returns</dt><dd>A pending variant which will emit finished when the property has been retrieved. </dd></dl>
372
<a class="anchor" id="aba93f0a84612cc6c2adf866eaff3e763"></a>
373
<div class="memitem">
374
<div class="memproto">
375
<table class="mlabels">
377
<td class="mlabels-left">
378
<table class="memname">
380
<td class="memname"><a class="el" href="a00452.html">Tp::PendingVariant</a>* Tp::Client::ChannelInterface::requestPropertyTargetHandle </td>
382
<td class="paramname"></td><td>)</td>
387
<td class="mlabels-right">
388
<span class="mlabels"><span class="mlabel">inline</span></span> </td>
391
</div><div class="memdoc">
392
<p>Asynchronous getter for the remote object property <code>TargetHandle</code> of type <code>uint</code>.</p>
394
<p>The handle (a representation for the identifier) of the contact,
395
chatroom, etc. with which this handle communicates. Its type
396
is given by the <a class="el" href="a00184.html#a389f3d423b4da14c328fd0ddbe20b8ae">TargetHandleType </a>
399
<p>This is fixed for the lifetime of the channel, so channels which
400
could potentially be used to communicate with multiple contacts,
401
and do not have an identity of their own (such as a Handle_Type_Room
402
handle), must have TargetHandleType set to Handle_Type_None and
403
TargetHandle set to 0.</p>
405
<p>Unlike in the telepathy-spec 0.16 API, there is no particular
406
uniqueness guarantee - there can be many channels with the same
407
(channel type, handle type, handle) tuple. This is necessary
408
to support conversation threads in XMPP and SIP, for example.</p>
410
<p>If this is present in a channel request, it must be nonzero,
411
<a class="el" href="a00184.html#a389f3d423b4da14c328fd0ddbe20b8ae">TargetHandleType </a>
412
MUST be present and not Handle_Type_None, and
413
<a class="el" href="a00184.html#aa04a1d3032316883c6ce5085f20caf68">TargetID </a> MUST NOT be
414
present. Properties from
415
org.freedesktop.Telepathy.Channel.Interface.Addressing1
416
MUST NOT be present.</p>
418
<p>The channel that satisfies the request MUST either:</p>
421
<li>have the specified TargetHandle property; or</li>
422
<li>have <a class="el" href="a00184.html#a389f3d423b4da14c328fd0ddbe20b8ae">TargetHandleType </a> =
423
Handle_Type_None, TargetHandle = 0, and be configured such that
424
it could communicate with the specified handle in some other way
425
(e.g. have the requested contact handle in its Group
428
<dl class="section return"><dt>Returns</dt><dd>A pending variant which will emit finished when the property has been retrieved. </dd></dl>
432
<a class="anchor" id="aa04a1d3032316883c6ce5085f20caf68"></a>
433
<div class="memitem">
434
<div class="memproto">
435
<table class="mlabels">
437
<td class="mlabels-left">
438
<table class="memname">
440
<td class="memname"><a class="el" href="a00452.html">Tp::PendingVariant</a>* Tp::Client::ChannelInterface::requestPropertyTargetID </td>
442
<td class="paramname"></td><td>)</td>
447
<td class="mlabels-right">
448
<span class="mlabels"><span class="mlabel">inline</span></span> </td>
451
</div><div class="memdoc">
452
<p>Asynchronous getter for the remote object property <code>TargetID</code> of type <code>QString</code>.</p>
454
<p>The string that would result from inspecting the
455
<a class="el" href="a00184.html#aba93f0a84612cc6c2adf866eaff3e763">TargetHandle </a>
456
property (i.e. the identifier in the IM protocol of the contact,
457
room, etc. with which this channel communicates), or the empty
458
string if the TargetHandle is 0.</p>
460
<div class="rationale">
461
<p>The presence of this property avoids the following race
465
<li>New channel C is signalled with target handle T</li>
466
<li>Client calls <a class="el" href="a00267.html#a7327cef43f7cfd1fe915727689d10edd">ConnectionInterface::InspectHandles()</a> (CONTACT,
468
<li>Channel C closes, removing the last reference to handle T</li>
469
<li> <a class="el" href="a00267.html#a7327cef43f7cfd1fe915727689d10edd">ConnectionInterface::InspectHandles()</a> (CONTACT,
470
[T]) returns an error</li>
474
<p>If this is present in a channel request,
475
<a class="el" href="a00184.html#a389f3d423b4da14c328fd0ddbe20b8ae">TargetHandleType </a>
476
MUST be present and not Handle_Type_None, and
477
<a class="el" href="a00184.html#aba93f0a84612cc6c2adf866eaff3e763">TargetHandle </a> MUST NOT be
478
present. Properties from
479
org.freedesktop.Telepathy.Channel.Interface.Addressing1
480
MUST NOT be present.The request MUST fail with error InvalidHandle,
481
without side-effects, if the requested TargetID would not be
483
<a class="el" href="a00267.html#a9358410e2c3e263d29dd071cb1c03ec3">ConnectionInterface::RequestHandles()</a> .</p>
485
<p>The returned channel must be related to the handle corresponding
486
to the given identifier, in the same way as if TargetHandle
487
had been part of the request instead.</p>
489
<div class="rationale">
490
<p>Requesting channels with a string identifier saves a round-trip
491
(the call to RequestHandles). It also allows the channel
492
dispatcher to accept a channel request for an account that is not
493
yet connected (and thus has no valid handles), bring the account
494
online, and pass on the same parameters to the new connection's
495
CreateChannel method.</p>
497
<dl class="section return"><dt>Returns</dt><dd>A pending variant which will emit finished when the property has been retrieved. </dd></dl>
501
<a class="anchor" id="a389f3d423b4da14c328fd0ddbe20b8ae"></a>
502
<div class="memitem">
503
<div class="memproto">
504
<table class="mlabels">
506
<td class="mlabels-left">
507
<table class="memname">
509
<td class="memname"><a class="el" href="a00452.html">Tp::PendingVariant</a>* Tp::Client::ChannelInterface::requestPropertyTargetHandleType </td>
511
<td class="paramname"></td><td>)</td>
516
<td class="mlabels-right">
517
<span class="mlabels"><span class="mlabel">inline</span></span> </td>
520
</div><div class="memdoc">
521
<p>Asynchronous getter for the remote object property <code>TargetHandleType</code> of type <code>uint</code>.</p>
523
<p>The type of <a class="el" href="a00184.html#aba93f0a84612cc6c2adf866eaff3e763">TargetHandle </a> .</p>
525
<p>If this is omitted from a channel request, connection managers
526
SHOULD treat this as equivalent to Handle_Type_None.</p>
528
<p>If this is omitted or is Handle_Type_None,
529
<a class="el" href="a00184.html#aba93f0a84612cc6c2adf866eaff3e763">TargetHandle </a> and
530
<a class="el" href="a00184.html#aa04a1d3032316883c6ce5085f20caf68">TargetID </a> MUST be omitted from the
532
<dl class="section return"><dt>Returns</dt><dd>A pending variant which will emit finished when the property has been retrieved. </dd></dl>
536
<a class="anchor" id="a32516a093708b2b8accc930b8252dcfa"></a>
537
<div class="memitem">
538
<div class="memproto">
539
<table class="mlabels">
541
<td class="mlabels-left">
542
<table class="memname">
544
<td class="memname"><a class="el" href="a00452.html">Tp::PendingVariant</a>* Tp::Client::ChannelInterface::requestPropertyRequested </td>
546
<td class="paramname"></td><td>)</td>
551
<td class="mlabels-right">
552
<span class="mlabels"><span class="mlabel">inline</span></span> </td>
555
</div><div class="memdoc">
556
<p>Asynchronous getter for the remote object property <code>Requested</code> of type <code>bool</code>.</p>
558
<p>True if this channel was created in response to a local request,
560
<a class="el" href="a00267.html#aa47cba559bbbe54b170bec5f3e044801">ConnectionInterface::RequestChannel()</a>
562
<a class="el" href="a00303.html#a1c7158c9b48d622551be4ae53f555497">ConnectionInterfaceRequestsInterface::CreateChannel()</a> .</p>
564
<div class="rationale">
565
<p>The idea of this property is to distinguish between "incoming"
566
and "outgoing" channels, in a way that doesn't break down when
567
considering special cases like contact lists that are automatically
568
created on connection to the server, or chatrooms that an
569
IRC proxy/bouncer like irssi-proxy or bip was already in.</p>
571
<p>The reason we want to make that distinction is that UIs for
572
things that the user explicitly requested should start up
573
automatically, whereas for incoming messages and VoIP calls we
574
should first ask the user whether they want to open the messaging
575
UI or accept the call.</p>
578
<p>If the channel was not explicitly requested (even if it was
579
created as a side-effect of a call to one of those functions,
580
e.g. because joining a Tube in a MUC context on XMPP implies
581
joining that MUC), then this property is false.</p>
583
<p>For compatibility with older connection managers, clients SHOULD
584
assume that this property is true if they see a channel announced
586
<a class="el" href="a00267.html#abe677e48098e91a45b7179ccd177a482">ConnectionInterface::NewChannel()</a>
587
signal with the suppress_handler parameter set to true.</p>
589
<div class="rationale">
590
<p>In a correct connection manager, the only way to get such a
591
channel is to request it.</p>
594
<p>Clients MAY additionally assume that this property is false
595
if they see a channel announced by the NewChannel signal with the
596
suppress_handler parameter set to false.</p>
598
<div class="rationale">
599
<p>This is more controversial, since it's possible to get that
600
parameter set to false by requesting a channel. However, there's
601
no good reason to do so, and we've deprecated this practice.</p>
603
<p>In the particular case of the channel dispatcher, the only
604
side-effect of wrongly thinking a channel is unrequested
605
is likely to be that the user has to confirm that they want to
606
use it, so it seems fairly harmless to assume in the channel
607
dispatcher that channels with suppress_handler false are
608
indeed unrequested.</p>
611
<p>It does not make sense for this property to be in channel
612
requests—it will always be true for channels returned by
613
CreateChannel, and callers of EnsureChannel cannot control whether an
614
existing channel was originally requested locally—so it MUST NOT
616
<dl class="section return"><dt>Returns</dt><dd>A pending variant which will emit finished when the property has been retrieved. </dd></dl>
620
<a class="anchor" id="a88f912db7a4d0680d3d78d928369cbe7"></a>
621
<div class="memitem">
622
<div class="memproto">
623
<table class="mlabels">
625
<td class="mlabels-left">
626
<table class="memname">
628
<td class="memname"><a class="el" href="a00452.html">Tp::PendingVariant</a>* Tp::Client::ChannelInterface::requestPropertyInitiatorHandle </td>
630
<td class="paramname"></td><td>)</td>
635
<td class="mlabels-right">
636
<span class="mlabels"><span class="mlabel">inline</span></span> </td>
639
</div><div class="memdoc">
640
<p>Asynchronous getter for the remote object property <code>InitiatorHandle</code> of type <code>uint</code>.</p>
642
<p>The contact who initiated the channel; for instance, the contact
643
who invited the local user to a chatroom, or the contact who
644
initiated a call.</p>
646
<p>This does <em>not</em> necessarily represent the contact who
647
created the underlying protocol-level construct. For instance, if
648
Rob creates a chatroom, Will joins that chatroom, and Will invites Simon
649
to join it, then Simon will see Will as the InitiatorHandle of the
650
channel representing the chatroom.</p>
652
<div class="rationale">
653
<p>The room creator is generally a less useful piece of information
654
than the inviter, is less likely to be available at invitation
655
time (i.e. can't necessarily be an immutable property), and is
656
less likely to be available at all. The creator of a chatroom
657
is not currently available via Telepathy; if added in future, it
658
is likely to be made available as a property on the Chatroom
659
interface (<a href="http://bugs.freedesktop.org/show_bug.cgi?id=23151">bug 23151</a>).</p>
662
<p>For channels requested by the
663
local user, this MUST be the value of
664
<a class="el" href="a00267.html#a2e9535cf988e586fb1b8afc0c86c10ec">ConnectionInterface::SelfHandle </a>
665
at the time the channel was created (i.e. not a channel-specific
668
<div class="rationale">
669
<p>On some protocols, the SelfHandle may change (as signalled by
670
<a class="el" href="a00267.html#a8f6c3869242cb762dda55c24aa9497f3">ConnectionInterface::SelfContactChanged()</a> ),
671
but this property is immutable. Hence, locally-requested channels'
672
InitiatorHandle and InitiatorID may not match the current
673
SelfHandle; <a class="el" href="a00184.html#a32516a093708b2b8accc930b8252dcfa">Requested </a> can be used to
674
determine whether the channel was created locally.</p>
677
<p>For channels requested by a remote user, this MUST be their handle.
678
If unavailable or not applicable, this MUST be 0 (for instance,
679
contact lists are not really initiated by anyone in particular, and
680
it's easy to imagine a protocol where chatroom invitations can be
683
<p>For channels with the <a class="el" href="a00202.html">ChannelInterfaceGroupInterface</a>
684
interface, this SHOULD be the same
685
contact who is signalled as the "Actor" causing the self-handle
686
to be placed in the local-pending set.</p>
688
<p>This SHOULD NOT be a channel-specific handle, if possible.</p>
690
<p>It does not make sense for this property to be in channel
691
requests - the initiator will always be the local user - so it
692
MUST NOT be accepted.</p>
693
<dl class="section return"><dt>Returns</dt><dd>A pending variant which will emit finished when the property has been retrieved. </dd></dl>
697
<a class="anchor" id="af7de86e324a198e115d6957f3da83fa1"></a>
698
<div class="memitem">
699
<div class="memproto">
700
<table class="mlabels">
702
<td class="mlabels-left">
703
<table class="memname">
705
<td class="memname"><a class="el" href="a00452.html">Tp::PendingVariant</a>* Tp::Client::ChannelInterface::requestPropertyInitiatorID </td>
707
<td class="paramname"></td><td>)</td>
712
<td class="mlabels-right">
713
<span class="mlabels"><span class="mlabel">inline</span></span> </td>
716
</div><div class="memdoc">
717
<p>Asynchronous getter for the remote object property <code>InitiatorID</code> of type <code>QString</code>.</p>
719
<p>The string that would result from inspecting the
720
<a class="el" href="a00184.html#a88f912db7a4d0680d3d78d928369cbe7">InitiatorHandle </a>
721
property (i.e. the initiator's identifier in the IM protocol).</p>
723
<div class="rationale">
724
<p>The presence of this property avoids the following race
728
<li>New StreamedMedia channel C is signalled with initiator
730
<li>Client calls <a class="el" href="a00267.html#a7327cef43f7cfd1fe915727689d10edd">ConnectionInterface::InspectHandles()</a> (CONTACT,
732
<li>Channel C closes, removing the last reference to handle I</li>
733
<li> <a class="el" href="a00267.html#a7327cef43f7cfd1fe915727689d10edd">ConnectionInterface::InspectHandles()</a> (CONTACT,
734
[I]) returns an error</li>
735
<li>Client can indicate that a call was missed, but not who
740
<p>It does not make sense for this property to be in channel
741
requests - the initiator will always be the local user - so it
742
MUST NOT be accepted.</p>
743
<dl class="section return"><dt>Returns</dt><dd>A pending variant which will emit finished when the property has been retrieved. </dd></dl>
747
<a class="anchor" id="afedf34d3aac0c21bd9f6c49cc2709472"></a>
748
<div class="memitem">
749
<div class="memproto">
750
<table class="mlabels">
752
<td class="mlabels-left">
753
<table class="memname">
755
<td class="memname"><a class="el" href="a00453.html">Tp::PendingVariantMap</a>* Tp::Client::ChannelInterface::requestAllProperties </td>
757
<td class="paramname"></td><td>)</td>
762
<td class="mlabels-right">
763
<span class="mlabels"><span class="mlabel">inline</span></span> </td>
766
</div><div class="memdoc">
767
<p>Request all of the <a class="el" href="a00865.html">DBus</a> properties on the interface.</p>
768
<dl class="section return"><dt>Returns</dt><dd>A pending variant map which will emit finished when the properties have been retrieved. </dd></dl>
772
<a class="anchor" id="a822439bf7adb2ce890cf8066ea01a1ff"></a>
773
<div class="memitem">
774
<div class="memproto">
775
<table class="mlabels">
777
<td class="mlabels-left">
778
<table class="memname">
780
<td class="memname">QDBusPendingReply Tp::Client::ChannelInterface::Close </td>
782
<td class="paramtype">int </td>
783
<td class="paramname"><em>timeout</em> = <code>-1</code></td><td>)</td>
788
<td class="mlabels-right">
789
<span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">slot</span></span> </td>
792
</div><div class="memdoc">
793
<p>Begins a call to the D-Bus method <code>Close</code> on the remote object.</p>
794
<p>Request that the channel be closed. This is not the case until the Closed signal has been emitted, and depending on the connection manager this may simply remove you from the channel on the server, rather than causing it to stop existing entirely. Some channels such as contact list channels may not be closed.</p>
795
<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>
796
<dl class="params"><dt>Parameters</dt><dd>
797
<table class="params">
798
<tr><td class="paramname">timeout</td><td>The timeout in milliseconds. </td></tr>
805
<a class="anchor" id="aa14a76049f40ba119845f2c52f84bdeb"></a>
806
<div class="memitem">
807
<div class="memproto">
808
<table class="mlabels">
810
<td class="mlabels-left">
811
<table class="memname">
813
<td class="memname">QDBusPendingReply<QString> Tp::Client::ChannelInterface::GetChannelType </td>
815
<td class="paramtype">int </td>
816
<td class="paramname"><em>timeout</em> = <code>-1</code></td><td>)</td>
821
<td class="mlabels-right">
822
<span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">slot</span></span> </td>
825
</div><div class="memdoc">
826
<p>Begins a call to the D-Bus method <code>GetChannelType</code> on the remote object.</p>
827
<p>Returns the interface name for the type of this channel. Clients SHOULD use the ChannelType property instead, falling back to this method only if necessary. The GetAll method lets clients retrieve all properties in one round-trip.</p>
828
<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>
829
<dl class="params"><dt>Parameters</dt><dd>
830
<table class="params">
831
<tr><td class="paramname">timeout</td><td>The timeout in milliseconds.</td></tr>
835
<dl class="section return"><dt>Returns</dt><dd><pre class="fragment">The interface name</pre> </dd></dl>
839
<a class="anchor" id="a135d5199c69e92039f81bcbad48d6e27"></a>
840
<div class="memitem">
841
<div class="memproto">
842
<table class="mlabels">
844
<td class="mlabels-left">
845
<table class="memname">
847
<td class="memname">QDBusPendingReply<uint, uint> Tp::Client::ChannelInterface::GetHandle </td>
849
<td class="paramtype">int </td>
850
<td class="paramname"><em>timeout</em> = <code>-1</code></td><td>)</td>
855
<td class="mlabels-right">
856
<span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">slot</span></span> </td>
859
</div><div class="memdoc">
860
<p>Begins a call to the D-Bus method <code>GetHandle</code> on the remote object.</p>
861
<p>Returns the handle type and number if this channel represents a communication with a particular contact, room or server-stored list, or zero if it is transient and defined only by its contents. Clients SHOULD use the TargetHandle and TargetHandleType properties instead, falling back to this method only if necessary. The GetAll method lets clients retrieve all properties in one round-trip.</p>
862
<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>
863
<dl class="params"><dt>Parameters</dt><dd>
864
<table class="params">
865
<tr><td class="paramname">timeout</td><td>The timeout in milliseconds.</td></tr>
869
<dl class="section return"><dt>Returns</dt><dd><pre class="fragment">The same as TargetHandleType.
872
<pre class="fragment">The same as TargetHandle.</pre> </dd></dl>
876
<a class="anchor" id="a65855cac589751eee7717e266caa7c6c"></a>
877
<div class="memitem">
878
<div class="memproto">
879
<table class="mlabels">
881
<td class="mlabels-left">
882
<table class="memname">
884
<td class="memname">QDBusPendingReply<QStringList> Tp::Client::ChannelInterface::GetInterfaces </td>
886
<td class="paramtype">int </td>
887
<td class="paramname"><em>timeout</em> = <code>-1</code></td><td>)</td>
892
<td class="mlabels-right">
893
<span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">slot</span></span> </td>
896
</div><div class="memdoc">
897
<p>Begins a call to the D-Bus method <code>GetInterfaces</code> on the remote object.</p>
898
<p>Get the optional interfaces implemented by the channel. Clients SHOULD use the Interfaces property instead, falling back to this method only if necessary. The GetAll method lets clients retrieve all properties in one round-trip.</p>
899
<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>
900
<dl class="params"><dt>Parameters</dt><dd>
901
<table class="params">
902
<tr><td class="paramname">timeout</td><td>The timeout in milliseconds.</td></tr>
906
<dl class="section return"><dt>Returns</dt><dd><pre class="fragment">An array of the D-Bus interface names</pre> </dd></dl>
910
<a class="anchor" id="a42005b6ea5c4fb962a2a8789a35741da"></a>
911
<div class="memitem">
912
<div class="memproto">
913
<table class="mlabels">
915
<td class="mlabels-left">
916
<table class="memname">
918
<td class="memname">void Tp::Client::ChannelInterface::Closed </td>
920
<td class="paramname"></td><td>)</td>
925
<td class="mlabels-right">
926
<span class="mlabels"><span class="mlabel">signal</span></span> </td>
929
</div><div class="memdoc">
930
<p>Represents the signal <code>Closed</code> on the remote object.</p>
931
<p>Emitted when the channel has been closed. Method calls on the channel are no longer valid after this signal has been emitted, and the connection manager may then remove the object from the bus at any point. </p>
935
<a class="anchor" id="a0a29ac5a212f2e0b0e9db5544d245ee1"></a>
936
<div class="memitem">
937
<div class="memproto">
938
<table class="mlabels">
940
<td class="mlabels-left">
941
<table class="memname">
943
<td class="memname">void Tp::Client::ChannelInterface::invalidate </td>
945
<td class="paramtype"><a class="el" href="a00339.html">Tp::DBusProxy</a> * </td>
350
946
<td class="paramname"><em>proxy</em>, </td>