comparison plugins/SIGNALS @ 2102:899c22dcee42

[gaim-migrate @ 2112] I haven't actually tested that it works, but theoretically it does. committer: Tailor Script <tailor@pidgin.im>
author Eric Warmenhoven <eric@warmenhoven.org>
date Wed, 01 Aug 2001 20:31:53 +0000
parents 08ac51210d09
children 0b81421021fd
comparison
equal deleted inserted replaced
2101:dd3aa315519d 2102:899c22dcee42
21 event_chat_send, 21 event_chat_send,
22 event_warned, 22 event_warned,
23 event_error, 23 event_error,
24 event_quit, 24 event_quit,
25 event_new_conversation, 25 event_new_conversation,
26 event_set_info 26 event_set_info,
27 event_draw_menu,
28 event_im_displayed
27 }; 29 };
28 30
29 To add a signal handler, call the fuction gaim_signal_connect with the 31 To add a signal handler, call the fuction gaim_signal_connect with the
30 following arguments: 32 following arguments:
31 33
255 event_set_info: 257 event_set_info:
256 struct gaim_connection *gc, char *info 258 struct gaim_connection *gc, char *info
257 259
258 Called when the user sends his profile to the server. 'info' is the 260 Called when the user sends his profile to the server. 'info' is the
259 profile being sent. 261 profile being sent.
262
263 event_draw_menu:
264 GtkWidget *menu, char *name
265
266 Called when you right-click on a buddy.
267
268 'menu' is the menu that is about to be displayed.
269 'name' is the name of the buddy that was clicked.
270
271 event_im_displayed:
272 struct gaim_connection *gc, char *who, char **what
273
274 This is called after what you send is displayed but before it's
275 actually sent. That is, when the user clicks the "send" button
276 in an IM window, first it gets passed to event_im_send handlers,
277 then it gets displayed, then it gets passed to these handlers, and
278 then it gets sent over the wire. This is useful for when you want
279 to encrypt something on the way out, or when you want to send a
280 response and have it displayed after what triggered the response.
281
282 'gc' is the connection the message was received on.
283 'who' is who sent the message.
284 'what' is what was sent. It's expected that you modify this. If
285 you set *what to NULL the message won't be sent, but the preferred
286 way of doing this is to attach to event_im_send so that it really
287 won't be displayed at all.