blob: b59ef72a38f8dcb74b59a670c5ccf69f43974124 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
|
<?xml version="1.0" ?>
<node name="/Channel_Dispatcher_Interface_Operation_List"
xmlns:tp="http://telepathy.freedesktop.org/wiki/DbusSpec#extensions-v0">
<tp:copyright>Copyright (C) 2008 Collabora Ltd.</tp:copyright>
<tp:copyright>Copyright (C) 2008 Nokia Corporation</tp:copyright>
<tp:license xmlns="http://www.w3.org/1999/xhtml">
<p>This library is free software; you can redistribute it and/or
modify it under the terms of the GNU Lesser General Public
License as published by the Free Software Foundation; either
version 2.1 of the License, or (at your option) any later version.</p>
<p>This library is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
Lesser General Public License for more details.</p>
<p>You should have received a copy of the GNU Lesser General Public
License along with this library; if not, write to the Free Software
Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301,
USA.</p>
</tp:license>
<interface name="org.freedesktop.Telepathy.ChannelDispatcher.Interface.OperationList.DRAFT"
tp:causes-havoc="experimental">
<tp:requires interface="org.freedesktop.Telepathy.ChannelDispatcher.DRAFT"/>
<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
<p>This interface allows users of the ChannelDispatcher to enumerate
all the pending dispatch operations, with change notification.</p>
<tp:rationale>
<p>The existence of the
<tp:member-ref>DispatchOperations</tp:member-ref> property allows a
newly started approver to pick up existing dispatch operations.</p>
<p>This is on a separate interface so clients that aren't interested
in doing this aren't woken up by its signals.</p>
</tp:rationale>
</tp:docstring>
<tp:struct name="Dispatch_Operation_Details"
array-name="Dispatch_Operation_Details_List">
<tp:docstring>
Details of a channel dispatch operation.
</tp:docstring>
<tp:member name="Channel_Dispatch_Operation" type="o">
<tp:docstring>
The object path of the
<tp:dbus-ref
namespace="org.freedesktop.Telepathy">ChannelDispatchOperation</tp:dbus-ref>.
</tp:docstring>
</tp:member>
<tp:member name="Properties" type="a{sv}"
tp:type="Qualified_Property_Value_Map">
<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
<p>Properties of the channel dispatch operation.</p>
<p>Connection managers MUST NOT include properties in this mapping
if their values can change. Clients MUST ignore properties
that appear in this mapping if their values can change.</p>
<tp:rationale>
<p>The rationale is the same as for
<tp:type-ref>Channel_Details</tp:type-ref>.</p>
</tp:rationale>
<p>Each dictionary MUST contain at least the following keys:</p>
<ul>
<li><tp:dbus-ref>org.freedesktop.Telepathy.ChannelDispatchOperation.DRAFT.Interfaces</tp:dbus-ref></li>
<li><tp:dbus-ref>org.freedesktop.Telepathy.ChannelDispatchOperation.DRAFT.Connection</tp:dbus-ref></li>
<li><tp:dbus-ref>org.freedesktop.Telepathy.ChannelDispatchOperation.DRAFT.Account</tp:dbus-ref></li>
<li><tp:dbus-ref>org.freedesktop.Telepathy.ChannelDispatchOperation.DRAFT.Channels</tp:dbus-ref></li>
<li><tp:dbus-ref>org.freedesktop.Telepathy.ChannelDispatchOperation.DRAFT.PossibleHandlers</tp:dbus-ref></li>
</ul>
</tp:docstring>
</tp:member>
</tp:struct>
<property
name="DispatchOperations" tp:name-for-bindings="Dispatch_Operations"
type="a(oa{sv})" tp:type="Dispatch_Operation_Details[]" access="read">
<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
<p>The list of ChannelDispatchOperation objects currently being
processed. Change notification is via the
<tp:member-ref>NewDispatchOperation</tp:member-ref> and
<tp:member-ref>DispatchOperationFinished</tp:member-ref> signals.</p>
</tp:docstring>
</property>
<signal name="NewDispatchOperation"
tp:name-for-bindings="New_Dispatch_Operation">
<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
<p>Emitted when a dispatch operation is added to
<tp:member-ref>DispatchOperations</tp:member-ref>.</p>
</tp:docstring>
<arg name="Dispatch_Operation" type="o">
<tp:docstring>
The dispatch operation that was created.
</tp:docstring>
</arg>
<arg name="Properties"
type="a{sv}" tp:type="Qualified_Property_Value_Map">
<tp:docstring>
The same properties that would appear in the Properties member of
<tp:type-ref>Dispatch_Operation_Details</tp:type-ref>.
</tp:docstring>
</arg>
</signal>
<signal name="DispatchOperationFinished"
tp:name-for-bindings="Dispatch_Operation_Finished">
<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
Emitted when a dispatch operation finishes (i.e. exactly once per
emission of <tp:dbus-ref
namespace="org.freedesktop.Telepathy">ChannelDispatchOperation.DRAFT.Finished</tp:dbus-ref>).
<tp:rationale>
Strictly speaking this is redundant with
ChannelDispatchOperation.Finished, but it provides full
change-notification for the
<tp:member-ref>DispatchOperations</tp:member-ref> property.
</tp:rationale>
</tp:docstring>
<arg name="Dispatch_Operation" type="o">
<tp:docstring>
The dispatch operation that was closed.
</tp:docstring>
</arg>
</signal>
</interface>
</node>
<!-- vim:set sw=2 sts=2 et ft=xml: -->
|
