diff -r 9b0f74b6b3d9 -r 884a5385bb2c doc/reference/pidgin/signals_gtkblist.xml --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/doc/reference/pidgin/signals_gtkblist.xml Fri Jan 31 17:31:59 2014 +0530 @@ -0,0 +1,146 @@ + + + +Buddy List signals + + +List of signals + + "gtkblist-hiding" + "gtkblist-unhiding" + "gtkblist-created" + "drawing-tooltip" + "drawing-buddy" + + + + +Signal details + + + The <literal>"gtkblist-hiding"</literal> signal + +void user_function (PurpleBuddyList *blist, + gpointer user_data) + + +Emitted when the buddy list is about to be hidden. + + + + blist : + The buddy list. + + + user_data : + user data set when the signal handler was connected. + + + + + + The <literal>"gtkblist-unhiding"</literal> signal + +void user_function (PurpleBuddyList *blist, + gpointer user_data) + + +Emitted when the buddy list is about to be unhidden. + + + + blist : + The buddy list. + + + user_data : + user data set when the signal handler was connected. + + + + + + The <literal>"gtkblist-created"</literal> signal + +void user_function (PurpleBuddyList *blist, + gpointer user_data) + + +Emitted when the buddy list is created. + + + + blist : + The buddy list. + + + user_data : + user data set when the signal handler was connected. + + + + + + The <literal>"drawing-tooltip"</literal> signal + +void user_function (PurpleBlistNode *node, + GString *text, + gboolean full, + gpointer user_data) + + +Emitted just before a tooltip is displayed. text is a standard GString, so the plugin can modify the text that will be displayed. + + +Make sure to free *text before you replace it! + + + + node : + The blist node for the tooltip. + + + text : + A pointer to the text that will be displayed. + + + full : + Whether we're doing a full tooltip for the priority buddy or a compact tooltip for a non-priority buddy. + + + user_data : + user data set when the signal handler was connected. + + + + + + The <literal>"drawing-buddy"</literal> signal + +char * user_function (PurpleBuddy *buddy, + gpointer user_data) + + +Emitted to allow plugins to handle markup within a buddy's name or to override the default of no formatting for names shown in the buddy list. + + + + buddy : + A pointer to the PurpleBuddy that will be displayed. + + + user_data : + user data set when the signal handler was connected. + + + Returns : + The text to display (must be allocated), or NULL if no changes to the default behavior are desired. + + + + + + +