view doc/gtkblist-signals.dox @ 9417:9f6a28af7164

[gaim-migrate @ 10232] " IDLETRACK.DLL uses Windows hooks to record the last time the user pressed a key or moved the mouse. Windows hooks are a bit unfriendly in that they force the hook DLL into every process - so IDLETRACK.DLL gets added to every process after Gaim runs. This can mean that IDLETRACK.DLL doesn't get unloaded when Gaim stops, which causes a warning about being unable to write to IDLETRACK.DLL if you then upgrade Gaim. Further, hooking is a common tactic employed by key loggers. If the user has a program installed that checks for global hooks then it will warn the user that Gaim may contain a key logger. From Windows 2000 onwards Microsoft introduced an API function called GetLastInputInfo that returns the timer tick at the point that the user last pressed a key or moved the mouse. I have changed idletrack.c so that it will try to use this if it can, which avoids all the ugliness of having to use hooks, but it will fall back to using hooks if the function isn't present. This patch changes all three exported functions in idletrack.c. In wgaim_set_idlehooks it checks to see if GetLastInputInfo is present. If it is then the address of the function is recorded and no hooks are set. If it isn't then we're running on an old verison of Windows and the hooks are set as per current behaviour. In wgaim_remove_idlehooks the module handle taken for USER32.DLL by wgaim_set_idlehooks is released. In wgaim_get_lastactive the GetLastInputInfo function is called, if present. If it isn't present then the hooks will have run and the shared memory they write to will be read as per current behaviour. Both methods end up getting the timer tick of the last user activity, which is returned as per current behaviour." --Andrew Whewell committer: Tailor Script <[e-mail]>

+
鐃緒申��申鐃緒申/** @page gtkblist-signals GtkBlist Signals
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申 @signals
+
鐃緒申��申鐃緒申  @signal gtkblist-created
+
鐃緒申��申鐃緒申  @signal drawing-menu
+
鐃緒申��申鐃緒申  @signal drawing-tooltip
+
鐃緒申��申鐃緒申 @endsignals
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申 <hr>
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申 @signaldef gtkblist-created
+
鐃緒申��申鐃緒申  @signalproto
+
鐃緒申��申鐃緒申(*gtkblist-created)(GaimBuddyList *blist);
+
鐃緒申��申鐃緒申  @endsignalproto
+
鐃緒申��申鐃緒申  @signaldesc
+
鐃緒申��申鐃緒申   Emitted when the buddy list is created.
+
鐃緒申��申鐃緒申  @param blist The buddy list.
+
鐃緒申��申鐃緒申 @endsignaldef
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申 @signaldef drawing-menu
+
鐃緒申��申鐃緒申  @signalproto
+
鐃緒申��申鐃緒申void (*drawing-menu)(GtkMenu *menu, GaimBuddy *buddy);
+
鐃緒申��申鐃緒申  @endsignalproto
+
鐃緒申��申鐃緒申  @signaldesc
+
鐃緒申��申鐃緒申   Emitted when the user right clicks on a buddy or chat in the buddy list.
+
鐃緒申��申鐃緒申  @param menu The menu that will be shown.
+
鐃緒申��申鐃緒申  @param buddy The buddy or chat.
+
鐃緒申��申鐃緒申 @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
+
鐃緒申��申鐃緒申*/