---

w32taskbar.c File Reference

Functions for creating, setting and destroying the workspace tray icon. More...

Defines
#define	WM_TRAYMSG   WM_USER+1
Functions
LRESULT CALLBACK	TrayProc (HWND hwnd, UINT msg, WPARAM wParam, LPARAM lParam)
HWND	CreateTrayWindow (HINSTANCE hInstance)
BOOL	TraySetIcon (HWND hwnd, UINT uID, HICON hicon)
BOOL	TrayAddIcon (HWND hwnd, UINT uID, HICON hicon, const char *pszToolTip)
BOOL	TrayDeleteIcon (HWND hwnd, UINT uID)
Variables
const char	w32taskbar_rcs [] = "$Id: w32taskbar.c,v 2.1 2002/06/04 16:37:48 jongfoster Exp $"
const char	w32taskbar_h_rcs [] = W32TASKBAR_H_VERSION
HMENU	g_hmenuTray
HWND	g_hwndTrayX

---

Detailed Description

Functions for creating, setting and destroying the workspace tray icon.

Log:

w32taskbar.c,v

Revision 2.1 2002/06/04 16:37:48 jongfoster Adding Doxygen-style comments to variables

Revision 2.0 2002/06/04 14:34:21 jongfoster Moving source files to src/

Revision 1.7 2002/03/31 17:19:00 jongfoster Win32 only: Enabling STRICT to fix a VC++ compile warning.

Revision 1.6 2002/03/26 22:57:10 jongfoster Web server name should begin www.

Revision 1.5 2002/03/24 12:03:47 jongfoster Name change

Revision 1.4 2001/11/16 00:46:31 jongfoster Fixing compiler warnings

Revision 1.3 2001/05/22 18:56:28 oes CRLF -> LF

Revision 1.2 2001/05/20 15:07:54 jongfoster File is now ignored if _WIN_CONSOLE is defined.

Revision 1.1.1.1 2001/05/15 13:59:08 oes Initial import of version 2.9.3 source tree

---

Define Documentation

#define WM_TRAYMSG   WM_USER+1

Our custom message ID.

---

Function Documentation

HWND CreateTrayWindow (  HINSTANCE    hInstance )

Creates and returns the invisible window responsible for processing tray messages. Parameters: hInstance  instance handle of this application Returns: Handle of the systray window.

BOOL TrayAddIcon (  HWND    hwnd, UINT    uID, HICON    hicon, const char *    pszToolTip )

Adds a tray icon. Parameters: hwnd  handle of the systray window uID  user message number to notify systray window hicon  handle of icon to add to systray window pszToolTip  tool tip when mouse hovers over systray window Returns: Same as `Shell_NotifyIcon'.

BOOL TrayDeleteIcon (  HWND    hwnd, UINT    uID )

Deletes a tray icon. Parameters: hwnd  handle of the systray window uID  user message number to notify systray window Returns: Same as `Shell_NotifyIcon'.

LRESULT CALLBACK TrayProc (  HWND    hwnd, UINT    msg, WPARAM    wParam, LPARAM    lParam )  [static]

Call back procedure processes tray messages. Parameters: hwnd  handle of the systray window msg  message number wParam  first param for this message lParam  next param for this message Returns: Appropriate M$ window message handler codes.

BOOL TraySetIcon (  HWND    hwnd, UINT    uID, HICON    hicon )

Sets the tray icon to the specified shape. Parameters: hwnd  handle of the systray window uID  user message number to notify systray window hicon  set the current icon to this handle Returns: Same value as `Shell_NotifyIcon'.

---

Variable Documentation

HMENU g_hmenuTray [static]

The menu handle for the tray icon's pop-up menu.

HWND g_hwndTrayX [static]

The invisible window responsible for processing tray messages.

const char w32taskbar_h_rcs[] = W32TASKBAR_H_VERSION

Version information about w32taskbar.h.

const char w32taskbar_rcs[] = "$Id: w32taskbar.c,v 2.1 2002/06/04 16:37:48 jongfoster Exp $"

Version information about w32taskbar.c.

---