~ubuntu-branches/ubuntu/wily/telepathy-glib/wily

« back to all changes in this revision

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

  • Committer: Package Import Robot
  • Author(s): Sjoerd Simons
  • Date: 2011-11-01 11:26:09 UTC
  • mfrom: (1.6.32)
  • Revision ID: package-import@ubuntu.com-20111101112609-kdouxczbx1spr97b
Tags: 0.16.1-1
* New upstream release
* Use vala 0.14

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.1 (XML mode)">
 
11
<meta name="generator" content="GTK-Doc V1.17 (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">
116
116
<p>
117
117
A typical simple handler would look liks this:
118
118
</p>
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="keyword">static</span><span class="normal"> </span><span class="type">void</span>
149
 
<span class="function">my_handle_channels</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">TpSimpleHandler</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">handler</span><span class="symbol">,</span>
150
 
<span class="normal">   </span><span class="usertype">TpAccount</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">account</span><span class="symbol">,</span>
151
 
<span class="normal">   </span><span class="usertype">TpConnection</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">connection</span><span class="symbol">,</span>
152
 
<span class="normal">   </span><span class="usertype">GList</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">channels</span><span class="symbol">,</span>
153
 
<span class="normal">   </span><span class="usertype">GList</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">requests_satisfied</span><span class="symbol">,</span>
154
 
<span class="normal">   </span><span class="usertype">gint64</span><span class="normal"> user_action_time</span><span class="symbol">,</span>
155
 
<span class="normal">   </span><span class="usertype">GList</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">requests</span><span class="symbol">,</span>
156
 
<span class="normal">   </span><span class="usertype">TpHandleChannelsContext</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">context</span><span class="symbol">,</span>
157
 
<span class="normal">   </span><span class="usertype">gpointer</span><span class="normal"> user_data</span><span class="symbol">)</span>
158
 
<span class="cbracket">{</span>
159
 
<span class="normal"> </span><span class="comment">/* start handling the channels here */</span>
160
 
 
161
 
<span class="normal"> </span><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="normal"> </span><span class="symbol">(</span><span class="normal">context</span><span class="symbol">);</span>
162
 
<span class="cbracket">}</span>
163
 
 
164
 
<span class="normal">client </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="telepathy-glib-simple-handler.html#tp-simple-handler-new">tp_simple_handler_new</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">dbus</span><span class="symbol">,</span><span class="normal"> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS">FALSE</a></span><span class="symbol">,</span><span class="normal"> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS">FALSE</a></span><span class="symbol">,</span><span class="normal"> </span><span class="string">"MyHandler"</span><span class="symbol">,</span><span class="normal"> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS">FALSE</a></span><span class="symbol">,</span>
165
 
<span class="normal">   my_handle_channels</span><span class="symbol">,</span><span class="normal"> user_data</span><span class="symbol">);</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="normal"> </span><span class="symbol">(</span><span class="normal">client</span><span class="symbol">,</span><span class="normal"> </span><span class="function"><a href="telepathy-glib-asv.html#tp-asv-new">tp_asv_new</a></span><span class="normal"> </span><span class="symbol">(</span>
168
 
<span class="normal">     <a href="telepathy-glib-interfaces.html#TP-PROP-CHANNEL-CHANNEL-TYPE:CAPS">TP_PROP_CHANNEL_CHANNEL_TYPE</a></span><span class="symbol">,</span><span class="normal"> <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#G-TYPE-STRING:CAPS">G_TYPE_STRING</a></span><span class="symbol">,</span><span class="normal"> <a href="telepathy-glib-interfaces.html#TP-IFACE-CHANNEL-TYPE-TEXT:CAPS">TP_IFACE_CHANNEL_TYPE_TEXT</a></span><span class="symbol">,</span>
169
 
<span class="normal">     <a href="telepathy-glib-interfaces.html#TP-PROP-CHANNEL-TARGET-HANDLE-TYPE:CAPS">TP_PROP_CHANNEL_TARGET_HANDLE_TYPE</a></span><span class="symbol">,</span><span class="normal"> <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#G-TYPE-UINT:CAPS">G_TYPE_UINT</a></span><span class="symbol">,</span><span class="normal"> <a href="telepathy-glib-enums.html#TP-HANDLE-TYPE-CONTACT:CAPS">TP_HANDLE_TYPE_CONTACT</a></span><span class="symbol">,</span>
170
 
<span class="normal">     <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">));</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="normal"> </span><span class="symbol">(</span><span class="normal">client</span><span class="symbol">,</span><span class="normal"> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">);</span></pre></td>
173
 
      </tr>
174
 
    </tbody>
175
 
  </table>
176
 
</div>
177
 
 
 
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>
178
146
<p>
179
147
</p>
180
148
<p>
523
491
</div>
524
492
<div class="footer">
525
493
<hr>
526
 
          Generated by GTK-Doc V1.17.1</div>
 
494
          Generated by GTK-Doc V1.17</div>
527
495
</body>
528
496
</html>
 
 
b'\\ No newline at end of file'