Mercurial > pidgin
view doc/blist-signals.dox @ 9797:62eb9fe24692
[gaim-migrate @ 10665]
"This patch adds gaim_notify_userinfo() and a notify_userinfo() UI
callback. gaim_notify_userinfo() is much like
gaim_notify_formatted() except that it always takes a
GaimConnection* as its handle and has an
additional argument, const char* who.
gaim_gtk_notify_userinfo() currently passes all the information
except the GaimConnection* and the const char* who to
gaim_gtk_notify_formatted(). This could be changed in the future
to, for example, have a standardized window title which would
note the account and/or user associated with the information.
This is needed because some UIs (Adium, for example) don't want
to present the information in a standalone window - they want to
associate the information with a particular contact / buddy and
display it with that object's other information. Previously,
gaim_notify_formatted() was not useful for this purpose as it could
not be determined what user's info it was; gaim_notify_userinfo()
makes this possible.
This patch modifies notify.c and notify.h for the new function,
modifies gtknotify.c to register the ui op and pass calls to it on the
gaim_gtk_notify_formatted, and modifies all prpls except SILC
(which I don't understand well enough to modify, but there's no
actual harm in leaving it as gaim_notify_formatted() for now) to
use gaim_notify_userinfo() and pass their gc and username when
calling the function." -- Evan Schoenberg
committer: Tailor Script <tailor@pidgin.im>
author | Luke Schierer <lschiere@pidgin.im> |
---|---|
date | Fri, 20 Aug 2004 22:05:18 +0000 |
parents | 2583056be3a4 |
children | 201617d49573 |
line wrap: on
line source
/** @page blist-signals Buddy List Signals @signals @signal buddy-away @signal buddy-back @signal buddy-idle @signal buddy-unidle @signal buddy-signed-on @signal buddy-signed-off @signal update-idle @signal blist-node-extended-menu @endsignals <hr> @signaldef buddy-away @signalproto void (*buddy_away)(struct buddy *buddy); @endsignalproto @signaldesc Emitted when a buddy on your buddy list goes away. @param buddy The buddy that went away. @endsignaldef @signaldef buddy-back @signalproto void (*buddy_back)(struct buddy *buddy); @endsignalproto @signaldesc Emitted when a buddy on your buddy list comes back from being away. @param buddy The buddy that came back from being away. @endsignaldef @signaldef buddy-idle @signalproto void (*buddy_idle)(struct buddy *buddy); @endsignalproto @signaldesc Emitted when a buddy on your buddy list becomes idle. @param buddy The buddy that became idle. @endsignaldef @signaldef buddy-unidle @signalproto void (*buddy_unidle)(struct buddy *buddy); @endsignalproto @signaldesc Emitted when a buddy on your buddy list returns from being idle. @param buddy The buddy that returned from being idle. @endsignaldef @signaldef buddy-idle-updated @signalproto void (*buddy_idle_updated)(struct buddy *buddy); @endsignalproto @signaldesc Emitted when a buddy's idle time changes. The exceptions are when the buddy goes from being idle to being unidle, or from unidle to idle. @param buddy The buddy whose idle time changed. @endsignaldef @signaldef buddy-signed-on @signalproto void (*buddy_signed_on)(struct buddy *buddy); @endsignalproto @signaldesc Emitted when a buddy on your buddy list signs on. @param buddy The buddy that signed on. @endsignaldef @signaldef buddy-signed-off @signalproto void (*buddy_signed_off)(struct buddy *buddy); @endsignalproto @signaldesc Emitted when a buddy on your buddy list signs off. @param buddy The buddy that signed off. @endsignaldef @signaldef update-idle @signalproto void (*update_idle)(); @endsignalproto @signaldesc Emitted when the buddy list is refreshed and the idle times are updated. @endsignaldef @signaldef blist-node-extended-menu @signalproto void (*blist_node_extended_menu)(GaimBlistNode *node, GList **menu) @endsignalproto @signaldesc Emitted when a buddlist menu is being constructed @a menu is a pointer to a GList of GaimBlistNodeAction's allowing a plugin to add menu items @endsignaldef */ // vim: syntax=c tw=75 et