doc/reference/pidgin/gtkblist-signals.dox

branch
soc.2013.gobjectification.plugins
changeset 36900
423fbe5e5289
parent 29919
2e8615d80b0b
equal deleted inserted replaced
36899:b2591070c07b 36900:423fbe5e5289
1 /** @page gtkblist-signals GtkBlist Signals
2
3 @signals
4 @signal gtkblist-hiding
5 @signal gtkblist-unhiding
6 @signal gtkblist-created
7 @signal drawing-tooltip
8 @signal drawing-buddy
9 @endsignals
10
11 @see gtkblist.h
12
13 <hr>
14
15 @signaldef gtkblist-hiding
16 @signalproto
17 void (*gtkblist-hiding)(PurpleBuddyList *blist);
18 @endsignalproto
19 @signaldesc
20 Emitted when the buddy list is about to be hidden.
21 @param blist The buddy list.
22 @endsignaldef
23
24 @signaldef gtkblist-unhiding
25 @signalproto
26 void (*gtkblist-unhiding)(PurpleBuddyList *blist);
27 @endsignalproto
28 @signaldesc
29 Emitted when the buddy list is about to be unhidden.
30 @param blist The buddy list.
31 @endsignaldef
32
33 @signaldef gtkblist-created
34 @signalproto
35 void (*gtkblist-created)(PurpleBuddyList *blist);
36 @endsignalproto
37 @signaldesc
38 Emitted when the buddy list is created.
39 @param blist The buddy list.
40 @endsignaldef
41
42 @signaldef drawing-tooltip
43 @signalproto
44 void (*drawing-tooltip)(PurpleBlistNode *node, GString *text, gboolean full);
45 @endsignalproto
46 @signaldesc
47 Emitted just before a tooltip is displayed.
48 @a text is a standard GString, so the plugin can modify the text that
49 will be displayed.
50 @note
51 Make sure to free @a *text before you replace it!
52 @param node The blist node for the tooltip.
53 @param text A pointer to the text that will be displayed.
54 @param full Whether we're doing a full tooltip for the priority buddy or
55 a compact tooltip for a non-priority buddy.
56 @endsignaldef
57
58 @signaldef drawing-buddy
59 @signalproto
60 char *(*drawing-buddy)(PurpleBuddy *buddy);
61 @endsignalproto
62 @signaldesc
63 Emitted to allow plugins to handle markup within a buddy's name or to
64 override the default of no formatting for names shown in the buddy list.
65 @param buddy A pointer to the PurpleBuddy that will be displayed.
66 @return The text to display (must be allocated), or @c NULL if no
67 changes to the default behavior are desired.
68 @endsignaldef
69 */
70 // vim: syntax=c.doxygen tw=75 et

mercurial