view doc/gtkblist-signals.dox @ 9766:14d997822897

[gaim-migrate @ 10634] A patch from Stu Tomlinson that lets plugins use Gaim's gaim_gtkconv_button_new() function to create buttons without tooltips and/or callbacks. I like how Stu uses if (tooltip != NULL) instead of if (!tooltip) I started doing that after I saw Chip do it/I did a lot of Java programming. I like it because I feel like it's more clear and makes the code more readable. committer: Tailor Script <[e-mail]>

/** @page gtkblist-signals GtkBlist Signals

 @signals
  @signal gtkblist-created
  @signal drawing-tooltip
 @endsignals

 <hr>

 @signaldef gtkblist-created
  @signalproto
void (*gtkblist-created)(GaimBuddyList *blist);
  @endsignalproto
  @signaldesc
   Emitted when the buddy list is created.
  @param blist The buddy list.
 @endsignaldef

 @signaldef drawing-tooltip
  @signalproto
void (*drawing-tooltip)(GaimBlistNode *node, char **text);
  @endsignalproto
  @signaldesc
   Emitted just before a tooltip is displayed.
   @a text is a pointer to a string, so the plugin can replace the text that
   will be displayed.
  @note
   Make sure to free @a *text before you replace it!
  @param node The blist node for the tooltip.
  @param text A pointer to the text that will be displayed.
 @endsignaldef
*/