~ubuntu-branches/ubuntu/precise/telepathy-glib/precise-201111172307

« back to all changes in this revision

Viewing changes to docs/reference/html/telepathy-glib-simple-handler.html

  • Committer: Ken VanDine
  • Date: 2011-11-17 20:53:21 UTC
  • mfrom: (1.6.34 upstream)
  • Revision ID: ken.vandine@canonical.com-20111117205321-l704j7kr1zgw5v9h
New upstream release.

Show diffs side-by-side

added added

removed removed

Lines of Context:
8
8
<link rel="up" href="ch-service-base.html" title="Service-side implementation">
9
9
<link rel="prev" href="telepathy-glib-simple-approver.html" title="TpSimpleApprover">
10
10
<link rel="next" href="telepathy-glib-dtmf.html" title="DTMF dialstring interpreter">
11
 
<meta name="generator" content="GTK-Doc V1.17 (XML mode)">
 
11
<meta name="generator" content="GTK-Doc V1.18 (XML mode)">
12
12
<link rel="stylesheet" href="style.css" type="text/css">
13
13
</head>
14
14
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
52
52
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-simple-handler.html#TpSimpleHandler"><span class="type">TpSimpleHandler</span></a> *handler</code></em>,
53
53
                                                         <em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>,
54
54
                                                         <em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *connection</code></em>,
55
 
                                                         <em class="parameter"><code><span class="type">GList</span> *channels</code></em>,
56
 
                                                         <em class="parameter"><code><span class="type">GList</span> *requests_satisfied</code></em>,
 
55
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> *channels</code></em>,
 
56
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> *requests_satisfied</code></em>,
57
57
                                                         <em class="parameter"><code><span class="type">gint64</span> user_action_time</code></em>,
58
58
                                                         <em class="parameter"><code><a class="link" href="telepathy-glib-handle-channels-context.html#TpHandleChannelsContext"><span class="type">TpHandleChannelsContext</span></a> *context</code></em>,
59
 
                                                         <em class="parameter"><code><span class="type">gpointer</span> user_data</code></em>);
 
59
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
60
60
<a class="link" href="telepathy-glib-base-client.html#TpBaseClient"><span class="returnvalue">TpBaseClient</span></a> *      <a class="link" href="telepathy-glib-simple-handler.html#tp-simple-handler-new" title="tp_simple_handler_new ()">tp_simple_handler_new</a>               (<em class="parameter"><code><a class="link" href="telepathy-glib-dbus.html#TpDBusDaemon"><span class="type">TpDBusDaemon</span></a> *dbus</code></em>,
61
 
                                                         <em class="parameter"><code><span class="type">gboolean</span> bypass_approval</code></em>,
62
 
                                                         <em class="parameter"><code><span class="type">gboolean</span> requests</code></em>,
63
 
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *name</code></em>,
64
 
                                                         <em class="parameter"><code><span class="type">gboolean</span> uniquify</code></em>,
 
61
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> bypass_approval</code></em>,
 
62
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> requests</code></em>,
 
63
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>,
 
64
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> uniquify</code></em>,
65
65
                                                         <em class="parameter"><code><a class="link" href="telepathy-glib-simple-handler.html#TpSimpleHandlerHandleChannelsImpl" title="TpSimpleHandlerHandleChannelsImpl ()"><span class="type">TpSimpleHandlerHandleChannelsImpl</span></a> callback</code></em>,
66
 
                                                         <em class="parameter"><code><span class="type">gpointer</span> user_data</code></em>,
67
 
                                                         <em class="parameter"><code><span class="type">GDestroyNotify</span> destroy</code></em>);
 
66
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
 
67
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>);
68
68
<a class="link" href="telepathy-glib-base-client.html#TpBaseClient"><span class="returnvalue">TpBaseClient</span></a> *      <a class="link" href="telepathy-glib-simple-handler.html#tp-simple-handler-new-with-am" title="tp_simple_handler_new_with_am ()">tp_simple_handler_new_with_am</a>       (<em class="parameter"><code><a class="link" href="telepathy-glib-account-manager.html#TpAccountManager"><span class="type">TpAccountManager</span></a> *account_manager</code></em>,
69
 
                                                         <em class="parameter"><code><span class="type">gboolean</span> bypass_approval</code></em>,
70
 
                                                         <em class="parameter"><code><span class="type">gboolean</span> requests</code></em>,
71
 
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *name</code></em>,
72
 
                                                         <em class="parameter"><code><span class="type">gboolean</span> uniquify</code></em>,
 
69
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> bypass_approval</code></em>,
 
70
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> requests</code></em>,
 
71
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>,
 
72
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> uniquify</code></em>,
73
73
                                                         <em class="parameter"><code><a class="link" href="telepathy-glib-simple-handler.html#TpSimpleHandlerHandleChannelsImpl" title="TpSimpleHandlerHandleChannelsImpl ()"><span class="type">TpSimpleHandlerHandleChannelsImpl</span></a> callback</code></em>,
74
 
                                                         <em class="parameter"><code><span class="type">gpointer</span> user_data</code></em>,
75
 
                                                         <em class="parameter"><code><span class="type">GDestroyNotify</span> destroy</code></em>);
 
74
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
 
75
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>);
76
76
<a class="link" href="telepathy-glib-base-client.html#TpBaseClient"><span class="returnvalue">TpBaseClient</span></a> *      <a class="link" href="telepathy-glib-simple-handler.html#tp-simple-handler-new-with-factory" title="tp_simple_handler_new_with_factory ()">tp_simple_handler_new_with_factory</a>  (<em class="parameter"><code><a class="link" href="telepathy-glib-simple-client-factory.html#TpSimpleClientFactory"><span class="type">TpSimpleClientFactory</span></a> *factory</code></em>,
77
 
                                                         <em class="parameter"><code><span class="type">gboolean</span> bypass_approval</code></em>,
78
 
                                                         <em class="parameter"><code><span class="type">gboolean</span> requests</code></em>,
79
 
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *name</code></em>,
80
 
                                                         <em class="parameter"><code><span class="type">gboolean</span> uniquify</code></em>,
 
77
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> bypass_approval</code></em>,
 
78
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> requests</code></em>,
 
79
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>,
 
80
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> uniquify</code></em>,
81
81
                                                         <em class="parameter"><code><a class="link" href="telepathy-glib-simple-handler.html#TpSimpleHandlerHandleChannelsImpl" title="TpSimpleHandlerHandleChannelsImpl ()"><span class="type">TpSimpleHandlerHandleChannelsImpl</span></a> callback</code></em>,
82
 
                                                         <em class="parameter"><code><span class="type">gpointer</span> user_data</code></em>,
83
 
                                                         <em class="parameter"><code><span class="type">GDestroyNotify</span> destroy</code></em>);
 
82
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
 
83
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>);
84
84
</pre>
85
85
</div>
86
86
<div class="refsect1">
87
87
<a name="telepathy-glib-simple-handler.object-hierarchy"></a><h2>Object Hierarchy</h2>
88
88
<pre class="synopsis">
89
 
  GObject
 
89
  <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>
90
90
   +----<a class="link" href="telepathy-glib-base-client.html#TpBaseClient">TpBaseClient</a>
91
91
         +----TpSimpleHandler
92
92
</pre>
100
100
<div class="refsect1">
101
101
<a name="telepathy-glib-simple-handler.properties"></a><h2>Properties</h2>
102
102
<pre class="synopsis">
103
 
  "<a class="link" href="telepathy-glib-simple-handler.html#TpSimpleHandler--bypass-approval" title='The "bypass-approval" property'>bypass-approval</a>"          <span class="type">gboolean</span>              : Write / Construct Only
104
 
  "<a class="link" href="telepathy-glib-simple-handler.html#TpSimpleHandler--callback" title='The "callback" property'>callback</a>"                 <span class="type">gpointer</span>              : Write / Construct Only
105
 
  "<a class="link" href="telepathy-glib-simple-handler.html#TpSimpleHandler--destroy" title='The "destroy" property'>destroy</a>"                  <span class="type">gpointer</span>              : Write / Construct Only
106
 
  "<a class="link" href="telepathy-glib-simple-handler.html#TpSimpleHandler--requests" title='The "requests" property'>requests</a>"                 <span class="type">gboolean</span>              : Write / Construct Only
107
 
  "<a class="link" href="telepathy-glib-simple-handler.html#TpSimpleHandler--user-data" title='The "user-data" property'>user-data</a>"                <span class="type">gpointer</span>              : Write / Construct Only
 
103
  "<a class="link" href="telepathy-glib-simple-handler.html#TpSimpleHandler--bypass-approval" title='The "bypass-approval" property'>bypass-approval</a>"          <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Write / Construct Only
 
104
  "<a class="link" href="telepathy-glib-simple-handler.html#TpSimpleHandler--callback" title='The "callback" property'>callback</a>"                 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>              : Write / Construct Only
 
105
  "<a class="link" href="telepathy-glib-simple-handler.html#TpSimpleHandler--destroy" title='The "destroy" property'>destroy</a>"                  <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>              : Write / Construct Only
 
106
  "<a class="link" href="telepathy-glib-simple-handler.html#TpSimpleHandler--requests" title='The "requests" property'>requests</a>"                 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Write / Construct Only
 
107
  "<a class="link" href="telepathy-glib-simple-handler.html#TpSimpleHandler--user-data" title='The "user-data" property'>user-data</a>"                <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>              : Write / Construct Only
108
108
</pre>
109
109
</div>
110
110
<div class="refsect1">
116
116
<p>
117
117
A typical simple handler would look liks this:
118
118
</p>
119
 
<div class="informalexample"><pre class="programlisting">
120
 
static void
121
 
my_handle_channels (TpSimpleHandler *handler,
122
 
   TpAccount *account,
123
 
   TpConnection *connection,
124
 
   GList *channels,
125
 
   GList *requests_satisfied,
126
 
   gint64 user_action_time,
127
 
   GList *requests,
128
 
   TpHandleChannelsContext *context,
129
 
   gpointer user_data)
130
 
{
131
 
 /* start handling the channels here */
132
 
 
133
 
 tp_handle_channels_context_accept (context);
134
 
}
135
 
 
136
 
client = tp_simple_handler_new (dbus, FALSE, FALSE, "MyHandler", FALSE,
137
 
   my_handle_channels, user_data);
138
 
 
139
 
tp_base_client_take_handler_filter (client, tp_asv_new (
140
 
     TP_PROP_CHANNEL_CHANNEL_TYPE, G_TYPE_STRING, TP_IFACE_CHANNEL_TYPE_TEXT,
141
 
     TP_PROP_CHANNEL_TARGET_HANDLE_TYPE, G_TYPE_UINT, TP_HANDLE_TYPE_CONTACT,
142
 
     NULL));
143
 
 
144
 
tp_base_client_register (client, NULL);
145
 
</pre></div>
 
119
<div class="informalexample">
 
120
  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
 
121
    <tbody>
 
122
      <tr>
 
123
        <td class="listing_lines" align="right"><pre>1
 
124
2
 
125
3
 
126
4
 
127
5
 
128
6
 
129
7
 
130
8
 
131
9
 
132
10
 
133
11
 
134
12
 
135
13
 
136
14
 
137
15
 
138
16
 
139
17
 
140
18
 
141
19
 
142
20
 
143
21
 
144
22
 
145
23
 
146
24
 
147
25</pre></td>
 
148
        <td class="listing_code"><pre class="programlisting"><span class="gtkdoc kwb">static void</span>
 
149
<span class="function">my_handle_channels</span> <span class="gtkdoc opt">(</span>TpSimpleHandler <span class="gtkdoc opt">*</span>handler<span class="gtkdoc opt">,</span>
 
150
   TpAccount <span class="gtkdoc opt">*</span>account<span class="gtkdoc opt">,</span>
 
151
   TpConnection <span class="gtkdoc opt">*</span>connection<span class="gtkdoc opt">,</span>
 
152
   GList <span class="gtkdoc opt">*</span>channels<span class="gtkdoc opt">,</span>
 
153
   GList <span class="gtkdoc opt">*</span>requests_satisfied<span class="gtkdoc opt">,</span>
 
154
   gint64 user_action_time<span class="gtkdoc opt">,</span>
 
155
   GList <span class="gtkdoc opt">*</span>requests<span class="gtkdoc opt">,</span>
 
156
   TpHandleChannelsContext <span class="gtkdoc opt">*</span>context<span class="gtkdoc opt">,</span>
 
157
   gpointer user_data<span class="gtkdoc opt">)</span>
 
158
<span class="gtkdoc opt">{</span>
 
159
 <span class="comment">/* start handling the channels here */</span>
 
160
 
 
161
 <span class="function"><a href="telepathy-glib-handle-channels-context.html#tp-handle-channels-context-accept">tp_handle_channels_context_accept</a></span> <span class="gtkdoc opt">(</span>context<span class="gtkdoc opt">);</span>
 
162
<span class="gtkdoc opt">}</span>
 
163
 
 
164
client <span class="gtkdoc opt">=</span> <span class="function"><a href="telepathy-glib-simple-handler.html#tp-simple-handler-new">tp_simple_handler_new</a></span> <span class="gtkdoc opt">(</span>dbus<span class="gtkdoc opt">,</span> FALSE<span class="gtkdoc opt">,</span> FALSE<span class="gtkdoc opt">,</span> <span class="string">&quot;MyHandler&quot;</span><span class="gtkdoc opt">,</span> FALSE<span class="gtkdoc opt">,</span>
 
165
   my_handle_channels<span class="gtkdoc opt">,</span> user_data<span class="gtkdoc opt">);</span>
 
166
 
 
167
<span class="function"><a href="telepathy-glib-base-client.html#tp-base-client-take-handler-filter">tp_base_client_take_handler_filter</a></span> <span class="gtkdoc opt">(</span>client<span class="gtkdoc opt">,</span> <span class="function"><a href="telepathy-glib-asv.html#tp-asv-new">tp_asv_new</a></span> <span class="gtkdoc opt">(</span>
 
168
     TP_PROP_CHANNEL_CHANNEL_TYPE<span class="gtkdoc opt">,</span> G_TYPE_STRING<span class="gtkdoc opt">,</span> TP_IFACE_CHANNEL_TYPE_TEXT<span class="gtkdoc opt">,</span>
 
169
     TP_PROP_CHANNEL_TARGET_HANDLE_TYPE<span class="gtkdoc opt">,</span> G_TYPE_UINT<span class="gtkdoc opt">,</span> TP_HANDLE_TYPE_CONTACT<span class="gtkdoc opt">,</span>
 
170
     NULL<span class="gtkdoc opt">));</span>
 
171
 
 
172
<span class="function"><a href="telepathy-glib-base-client.html#tp-base-client-register">tp_base_client_register</a></span> <span class="gtkdoc opt">(</span>client<span class="gtkdoc opt">,</span> NULL<span class="gtkdoc opt">);</span></pre></td>
 
173
      </tr>
 
174
    </tbody>
 
175
  </table>
 
176
</div>
 
177
 
146
178
<p>
147
179
</p>
148
180
<p>
166
198
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-simple-handler.html#TpSimpleHandler"><span class="type">TpSimpleHandler</span></a> *handler</code></em>,
167
199
                                                         <em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>,
168
200
                                                         <em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *connection</code></em>,
169
 
                                                         <em class="parameter"><code><span class="type">GList</span> *channels</code></em>,
170
 
                                                         <em class="parameter"><code><span class="type">GList</span> *requests_satisfied</code></em>,
 
201
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> *channels</code></em>,
 
202
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> *requests_satisfied</code></em>,
171
203
                                                         <em class="parameter"><code><span class="type">gint64</span> user_action_time</code></em>,
172
204
                                                         <em class="parameter"><code><a class="link" href="telepathy-glib-handle-channels-context.html#TpHandleChannelsContext"><span class="type">TpHandleChannelsContext</span></a> *context</code></em>,
173
 
                                                         <em class="parameter"><code><span class="type">gpointer</span> user_data</code></em>);</pre>
 
205
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
174
206
<p>
175
207
Signature of the implementation of the HandleChannels method.
176
208
</p>
197
229
</tr>
198
230
<tr>
199
231
<td><p><span class="term"><em class="parameter"><code>channels</code></em> :</span></p></td>
200
 
<td>a <span class="type">GList</span> of <a class="link" href="telepathy-glib-channel.html#TpChannel"><span class="type">TpChannel</span></a>,
 
232
<td>a <a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> of <a class="link" href="telepathy-glib-channel.html#TpChannel"><span class="type">TpChannel</span></a>,
201
233
all having <a class="link" href="telepathy-glib-channel.html#TP-CHANNEL-FEATURE-CORE:CAPS" title="TP_CHANNEL_FEATURE_CORE"><code class="literal">TP_CHANNEL_FEATURE_CORE</code></a> prepared if possible. <span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> TelepathyGLib.Channel]</span>
202
234
</td>
203
235
</tr>
204
236
<tr>
205
237
<td><p><span class="term"><em class="parameter"><code>requests_satisfied</code></em> :</span></p></td>
206
 
<td>a <span class="type">GList</span> of
 
238
<td>a <a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> of
207
239
<a class="link" href="telepathy-glib-channel-request.html#TpChannelRequest"><span class="type">TpChannelRequest</span></a> having their object-path defined but are not guaranteed
208
240
to be prepared. <span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> TelepathyGLib.ChannelRequest]</span>
209
241
</td>
233
265
<div class="refsect2">
234
266
<a name="tp-simple-handler-new"></a><h3>tp_simple_handler_new ()</h3>
235
267
<pre class="programlisting"><a class="link" href="telepathy-glib-base-client.html#TpBaseClient"><span class="returnvalue">TpBaseClient</span></a> *      tp_simple_handler_new               (<em class="parameter"><code><a class="link" href="telepathy-glib-dbus.html#TpDBusDaemon"><span class="type">TpDBusDaemon</span></a> *dbus</code></em>,
236
 
                                                         <em class="parameter"><code><span class="type">gboolean</span> bypass_approval</code></em>,
237
 
                                                         <em class="parameter"><code><span class="type">gboolean</span> requests</code></em>,
238
 
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *name</code></em>,
239
 
                                                         <em class="parameter"><code><span class="type">gboolean</span> uniquify</code></em>,
 
268
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> bypass_approval</code></em>,
 
269
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> requests</code></em>,
 
270
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>,
 
271
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> uniquify</code></em>,
240
272
                                                         <em class="parameter"><code><a class="link" href="telepathy-glib-simple-handler.html#TpSimpleHandlerHandleChannelsImpl" title="TpSimpleHandlerHandleChannelsImpl ()"><span class="type">TpSimpleHandlerHandleChannelsImpl</span></a> callback</code></em>,
241
 
                                                         <em class="parameter"><code><span class="type">gpointer</span> user_data</code></em>,
242
 
                                                         <em class="parameter"><code><span class="type">GDestroyNotify</span> destroy</code></em>);</pre>
 
273
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
 
274
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>);</pre>
243
275
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
244
276
<h3 class="title">Warning</h3>
245
277
<p><code class="literal">tp_simple_handler_new</code> is deprecated and should not be used in newly-written code. New code should use <a class="link" href="telepathy-glib-simple-handler.html#tp-simple-handler-new-with-am" title="tp_simple_handler_new_with_am ()"><code class="function">tp_simple_handler_new_with_am()</code></a> instead.</p>
257
289
<tbody>
258
290
<tr>
259
291
<td><p><span class="term"><em class="parameter"><code>dbus</code></em> :</span></p></td>
260
 
<td>a <a class="link" href="telepathy-glib-dbus.html#TpDBusDaemon"><span class="type">TpDBusDaemon</span></a> object, may not be <code class="literal">NULL</code>
 
292
<td>a <a class="link" href="telepathy-glib-dbus.html#TpDBusDaemon"><span class="type">TpDBusDaemon</span></a> object, may not be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
261
293
</td>
262
294
</tr>
263
295
<tr>
305
337
<div class="refsect2">
306
338
<a name="tp-simple-handler-new-with-am"></a><h3>tp_simple_handler_new_with_am ()</h3>
307
339
<pre class="programlisting"><a class="link" href="telepathy-glib-base-client.html#TpBaseClient"><span class="returnvalue">TpBaseClient</span></a> *      tp_simple_handler_new_with_am       (<em class="parameter"><code><a class="link" href="telepathy-glib-account-manager.html#TpAccountManager"><span class="type">TpAccountManager</span></a> *account_manager</code></em>,
308
 
                                                         <em class="parameter"><code><span class="type">gboolean</span> bypass_approval</code></em>,
309
 
                                                         <em class="parameter"><code><span class="type">gboolean</span> requests</code></em>,
310
 
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *name</code></em>,
311
 
                                                         <em class="parameter"><code><span class="type">gboolean</span> uniquify</code></em>,
 
340
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> bypass_approval</code></em>,
 
341
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> requests</code></em>,
 
342
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>,
 
343
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> uniquify</code></em>,
312
344
                                                         <em class="parameter"><code><a class="link" href="telepathy-glib-simple-handler.html#TpSimpleHandlerHandleChannelsImpl" title="TpSimpleHandlerHandleChannelsImpl ()"><span class="type">TpSimpleHandlerHandleChannelsImpl</span></a> callback</code></em>,
313
 
                                                         <em class="parameter"><code><span class="type">gpointer</span> user_data</code></em>,
314
 
                                                         <em class="parameter"><code><span class="type">GDestroyNotify</span> destroy</code></em>);</pre>
 
345
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
 
346
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>);</pre>
315
347
<p>
316
348
Convenient function to create a new <a class="link" href="telepathy-glib-simple-handler.html#TpSimpleHandler"><span class="type">TpSimpleHandler</span></a> instance with a
317
349
specified <a class="link" href="telepathy-glib-account-manager.html#TpAccountManager"><span class="type">TpAccountManager</span></a>.
325
357
<tbody>
326
358
<tr>
327
359
<td><p><span class="term"><em class="parameter"><code>account_manager</code></em> :</span></p></td>
328
 
<td>an account manager, which may not be <code class="literal">NULL</code>
 
360
<td>an account manager, which may not be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
329
361
</td>
330
362
</tr>
331
363
<tr>
373
405
<div class="refsect2">
374
406
<a name="tp-simple-handler-new-with-factory"></a><h3>tp_simple_handler_new_with_factory ()</h3>
375
407
<pre class="programlisting"><a class="link" href="telepathy-glib-base-client.html#TpBaseClient"><span class="returnvalue">TpBaseClient</span></a> *      tp_simple_handler_new_with_factory  (<em class="parameter"><code><a class="link" href="telepathy-glib-simple-client-factory.html#TpSimpleClientFactory"><span class="type">TpSimpleClientFactory</span></a> *factory</code></em>,
376
 
                                                         <em class="parameter"><code><span class="type">gboolean</span> bypass_approval</code></em>,
377
 
                                                         <em class="parameter"><code><span class="type">gboolean</span> requests</code></em>,
378
 
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *name</code></em>,
379
 
                                                         <em class="parameter"><code><span class="type">gboolean</span> uniquify</code></em>,
 
408
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> bypass_approval</code></em>,
 
409
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> requests</code></em>,
 
410
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>,
 
411
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> uniquify</code></em>,
380
412
                                                         <em class="parameter"><code><a class="link" href="telepathy-glib-simple-handler.html#TpSimpleHandlerHandleChannelsImpl" title="TpSimpleHandlerHandleChannelsImpl ()"><span class="type">TpSimpleHandlerHandleChannelsImpl</span></a> callback</code></em>,
381
 
                                                         <em class="parameter"><code><span class="type">gpointer</span> user_data</code></em>,
382
 
                                                         <em class="parameter"><code><span class="type">GDestroyNotify</span> destroy</code></em>);</pre>
 
413
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
 
414
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>);</pre>
383
415
<p>
384
416
Convenient function to create a new <a class="link" href="telepathy-glib-simple-handler.html#TpSimpleHandler"><span class="type">TpSimpleHandler</span></a> instance with a
385
417
specified <a class="link" href="telepathy-glib-simple-client-factory.html#TpSimpleClientFactory"><span class="type">TpSimpleClientFactory</span></a>.
389
421
<tbody>
390
422
<tr>
391
423
<td><p><span class="term"><em class="parameter"><code>factory</code></em> :</span></p></td>
392
 
<td>a <a class="link" href="telepathy-glib-simple-client-factory.html#TpSimpleClientFactory"><span class="type">TpSimpleClientFactory</span></a>, which may not be <code class="literal">NULL</code>
 
424
<td>a <a class="link" href="telepathy-glib-simple-client-factory.html#TpSimpleClientFactory"><span class="type">TpSimpleClientFactory</span></a>, which may not be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
393
425
</td>
394
426
</tr>
395
427
<tr>
438
470
<a name="telepathy-glib-simple-handler.property-details"></a><h2>Property Details</h2>
439
471
<div class="refsect2">
440
472
<a name="TpSimpleHandler--bypass-approval"></a><h3>The <code class="literal">"bypass-approval"</code> property</h3>
441
 
<pre class="programlisting">  "bypass-approval"          <span class="type">gboolean</span>              : Write / Construct Only</pre>
 
473
<pre class="programlisting">  "bypass-approval"          <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Write / Construct Only</pre>
442
474
<p>
443
475
The value of the Handler.BypassApproval D-Bus property.
444
476
</p>
448
480
<hr>
449
481
<div class="refsect2">
450
482
<a name="TpSimpleHandler--callback"></a><h3>The <code class="literal">"callback"</code> property</h3>
451
 
<pre class="programlisting">  "callback"                 <span class="type">gpointer</span>              : Write / Construct Only</pre>
 
483
<pre class="programlisting">  "callback"                 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>              : Write / Construct Only</pre>
452
484
<p>
453
485
The <a class="link" href="telepathy-glib-simple-handler.html#TpSimpleHandlerHandleChannelsImpl" title="TpSimpleHandlerHandleChannelsImpl ()"><span class="type">TpSimpleHandlerHandleChannelsImpl</span></a> callback implementing the
454
486
HandleChannels D-Bus method.
455
487
</p>
456
488
<p>
457
 
This property can't be <code class="literal">NULL</code>.
 
489
This property can't be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.
458
490
</p>
459
491
<p class="since">Since 0.11.6</p>
460
492
</div>
461
493
<hr>
462
494
<div class="refsect2">
463
495
<a name="TpSimpleHandler--destroy"></a><h3>The <code class="literal">"destroy"</code> property</h3>
464
 
<pre class="programlisting">  "destroy"                  <span class="type">gpointer</span>              : Write / Construct Only</pre>
 
496
<pre class="programlisting">  "destroy"                  <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>              : Write / Construct Only</pre>
465
497
<p>
466
 
The <span class="type">GDestroyNotify</span> function called to free <a class="link" href="telepathy-glib-simple-handler.html#TpSimpleHandler--user-data" title='The "user-data" property'><span class="type">"user-data"</span></a>
 
498
The <a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> function called to free <a class="link" href="telepathy-glib-simple-handler.html#TpSimpleHandler--user-data" title='The "user-data" property'><span class="type">"user-data"</span></a>
467
499
when the <a class="link" href="telepathy-glib-simple-handler.html#TpSimpleHandler"><span class="type">TpSimpleHandler</span></a> is destroyed.
468
500
</p>
469
501
<p class="since">Since 0.11.6</p>
471
503
<hr>
472
504
<div class="refsect2">
473
505
<a name="TpSimpleHandler--requests"></a><h3>The <code class="literal">"requests"</code> property</h3>
474
 
<pre class="programlisting">  "requests"                 <span class="type">gboolean</span>              : Write / Construct Only</pre>
 
506
<pre class="programlisting">  "requests"                 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Write / Construct Only</pre>
475
507
<p>
476
 
If <code class="literal">TRUE</code>, the Handler will implement the Requests interface
 
508
If <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, the Handler will implement the Requests interface
477
509
</p>
478
510
<p>Default value: FALSE</p>
479
511
<p class="since">Since 0.11.6</p>
481
513
<hr>
482
514
<div class="refsect2">
483
515
<a name="TpSimpleHandler--user-data"></a><h3>The <code class="literal">"user-data"</code> property</h3>
484
 
<pre class="programlisting">  "user-data"                <span class="type">gpointer</span>              : Write / Construct Only</pre>
 
516
<pre class="programlisting">  "user-data"                <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>              : Write / Construct Only</pre>
485
517
<p>
486
518
The user-data pointer passed to <a class="link" href="telepathy-glib-simple-handler.html#TpSimpleHandler--callback" title='The "callback" property'><span class="type">"callback"</span></a>.
487
519
</p>
491
523
</div>
492
524
<div class="footer">
493
525
<hr>
494
 
          Generated by GTK-Doc V1.17</div>
 
526
          Generated by GTK-Doc V1.18</div>
495
527
</body>
496
528
</html>
 
 
b'\\ No newline at end of file'