How to wirte tray application procedure

    I wrote an application procedure on how to tray a dialog box in the bottom-right of the screen.

 you should learn about NOTIFYICONDATA structure.The MFC describe it like this:

  typedef struct _NOTIFYICONDATA {
    DWORD cbSize;
    HWND hWnd;
    UINT uID;
    UINT uFlags;
    UINT uCallbackMessage;
    HICON hIcon;
    TCHAR szTip[64];
    DWORD dwState; //Version 5.0
    DWORD dwStateMask; //Version 5.0
    TCHAR szInfo[256]; //Version 5.0
    union {
        UINT  uTimeout; //Version 5.0
        UINT  uVersion; //Version 5.0
    } DUMMYUNIONNAME;
    TCHAR szInfoTitle[64]; //Version 5.0
    DWORD dwInfoFlags; //Version 5.0
} NOTIFYICONDATA, *PNOTIFYICONDATA;

 

Members

cbSize

Size of this structure, in bytes.

hWnd

Handle to the window that will receive notification messages associated with an icon in the taskbar status area. The shell uses hWnd and uID to identify which icon on which to operate when Shell_NotifyIcon is invoked.

uID

Application-defined identifier of the taskbar icon. The shell uses hWnd and uID to identify which icon on which to operate when Shell_NotifyIcon is invoked. You can have multiple icons associated with a single hWnd by assigning each a diffent uID.

uFlags

Array of flags that indicate which of the other members contain valid data. This member can be a combination of the following:

Flag	Description
NIF_ICON	The hIcon member is valid.
NIF_MESSAGE	The uCallbackMessage member is valid.
NIF_TIP	The szTip member is valid.
NIF_STATE	The dwState and dwStateMask members are valid.
NIF_INFO	Use a balloon-style tooltip instead of a standard tooltip. The szInfo, uTimeout, szInfoTitle, and dwInfoFlags members are valid.

uCallbackMessage

Application-defined message identifier. The system uses this identifier to send notifications to the window identified in hWnd. These notifications are sent when a mouse event occurs in the bounding rectangle of the icon, or when the icon is selected or activated with the keyboard. The wParam parameter of the message contains the identifier of the taskbar icon in which the event occurred. The lParam parameter holds the mouse or keyboard message associated with the event. For example, when the mouse cursor moves over a taskbar icon, lParam is set to WM_MOUSEMOVE . See the Taskbar guide chapter for further discussion.

hIcon

Handle to the icon to be added, modified, or deleted.

szTip

Pointer to a NULL-terminated string with the text for a standard tooltip. It can have a maximum of 64 characters including the terminating NULL.

For Version 5.0 and later, szTip can have a maximum of 128 characters, including the terminating NULL.

dwState

Version 5.0 . State of the icon. There are two flags that can be set independently:

Flag	Description
NIS_HIDDEN	The icon is hidden.
NIS_SHAREDICON	The icon is shared.

dwStateMask

Version 5.0 . A value that specifies which bits of the state member will be retrieved or modified. For example, setting this member to NIS_HIDDEN will cause only the item's hidden state to be retrieved.

szInfo

Version 5.0 . Pointer to a NULL-terminated string with the text for a balloon-style tooltip. It can have a maximum of 255 characters. To remove the tooltip, set the NIF_INFO flag in uFlags and set szInfo to an empty string.

uTimeout

The timeout value, in milliseconds, for a balloon-style tooltip. The system enforces minimum and maximum timeout values. uTimeout values that are too large are set to the maximum value and values that are too small default to the minimum value. The system minimum and maximum timeout values are currently set at 10 seconds and 30 seconds, respectively. These values may change in future versions of Windows. See the remarks for further discussion of uTimeout. Union with uVersion.

uVersion

Version 5.0 . Specifies whether the shell notify icon interface should use Windows 95 or Windows 2000 behavior. This member is only employed when using Shell_NotifyIcon to send an NIM_VERSION message. Union with uTimeout.

Value	Description
0	Use the Windows 95 behavior.
NOTIFYICON_VERSION	Use the Windows 2000 behavior.

szInfoTitle

Version 5.0 . Pointer to a NULL-terminated string containing a title for a balloon tooltip. This title will be in boldface, and placed above the text. It can have a maximum of 63 characters.

dwInfoFlags

Version 5.0 . Flags that can be set to add an icon to a balloon tooltip. It will be placed to the left of the title. If the szTitleInfo member is zero-length, the icon will not be shown.

Flag	Description
NIIF_WARNING	A warning icon.
NIIF_ERROR	An error icon.
NIIF_INFO	An information icon.

Remarks

If you set the NIF_INFO flag in the uFlags member, the standard tooltip, will be replaced by a balloon tooltip. For more discussion of balloon tooltips, see the Tooltip Controls chapter.

No more than one balloon tooltip at at time will be displayed for the taskbar. If an application attempts to display a tooltip when one is already being displayed, the tooltip will not appear until the existing balloon tooltip has been visible for at least the system minum timeout value. For example, a balloon tooltip with uTimeout set to 30 seconds has been visible for seven seconds when another application attempts to display a balloon tooltip. If the system minimum timeout is ten seconds, the first tooltip will be displayed for an additional three seconds before being replaced by the second tooltip.

Note that several members of this structure are only supported for Shell32.dll versions 5.0 and later. To enable these members, include the following in your header:

#define _WIN32_IE 0x0500

However, you must initialize the structure with its size. If you use the size of the currently defined structure, the application may not run with the earlier versions of Shell32.dll, which expect a smaller structure. You can run your application on pre-5.0 versions of Shell32.dll by defining the appropriate version number (see Shell and Common Controls Versions). However, this may cause problems if your application also needs to run on systems with more recent versions.

Your application can remain compatible with all Shell32.dll versions while still using the current header files by setting the size of the NOTIFYICONDATA structure appropriately. Before initializing the structure, use the DllGetVersion function to determine which Shell32.dll version is installed on the system. If it is version 5.0 or greater, initialize the cbSize member with:

nid.cbSize = sizeof(NOTIFYICONDATA);

Setting cbSize to this value will enable all the version 5.0 enhancements. For earlier versions, the size of the pre-5.0 structure is given by the NOTIFYICONDATA_V1_SIZE constant. Initialize the cbSize member with:

nid.cbSize = NOTIFYICONDATA_V1_SIZE;

Using this value for cbSize will allow your application to use NOTIFYICONDATA with earlier Shell32.dll versions, although without the version 5.0 enhancements

 

But how to use it. here,I give you a simple sample as following code:

 

 1,define message by yourself in application procedure like this:

/****************************************************************************/
#define WM_MYTRAYMESSAGE (WM_USER+1)       //define message by yourself^^!
#define WM_MYMESSAGE (WM_USER+2)
/****************************************************************************/

 2, define some variable for your need in Dialog Box ;

xxx.h

   class CTrayMessageDemoDlg : public CDialog

{

   .....

   public:

    NOTIFYICONDATA m_myTray;

    HWND hwnd;
    CMenu m_myMenu;
    void InitTray();

  

}

xxx.cpp

  void CTrayMessageDemoDlg::InitTray()  
{
 m_myMenu.LoadMenu(IDR_MENU1);
 m_myTray.cbSize = sizeof(NOTIFYICONDATA);
 m_myTray.hIcon = AfxGetApp()->LoadIcon(IDR_MAINFRAME);  //load icon resource for tray
 m_myTray.hWnd = m_hWnd;                                 //Set window handle
 //char *m_str = _T("xiaohe");
 //strncpy(m_myTray.szTip,m_str,strlen(m_str)+1);
 m_myTray.uCallbackMessage = WM_MYTRAYMESSAGE;
 m_myTray.uFlags = NIF_ICON | NIF_MESSAGE | NIF_TIP;
 m_myTray.uID = IDR_MAINFRAME;
 Shell_NotifyIcon(NIM_ADD,&m_myTray);

}

 

3 add code in OnSysCommand as the following describtion.

 

void CTrayMessageDemoDlg::OnSysCommand(UINT nID, LPARAM lParam)
{
 if ((nID & 0xFFF0) == IDM_ABOUTBOX)
 {
  CAboutDlg dlgAbout;
  dlgAbout.DoModal();
 }
/************Add this code for minimize *****************************************************/
 else if ((nID & 0xFFF0)==SC_MINIMIZE)
 {
  ShowWindow(SW_HIDE);
  Shell_NotifyIcon(NIM_ADD,&m_myTray);
 }
 else if ((nID & 0xFFF0) == SC_CLOSE)
 {
  CDialog::OnCancel();                     //destroy the dialog box
  Shell_NotifyIcon(NIM_DELETE,&m_myTray);  //delete tray icon while dialog box destroyed^^!
  //PostNcDestroy();
 }
/**********************************************************************************************/

4, create menu and its ID is IDR_MENU1

5,define message like this.

xxx.h

  /************************************************************/
 afx_msg LRESULT OnMyTray(WPARAM wParam,LPARAM lParam);
/************************************************************/

xxx.cpp

/*****************************************************************/
 ON_MESSAGE(WM_MYTRAYMESSAGE,OnMyTray)
/******************************************************************/

LRESULT CTrayMessageDemoDlg::OnMyTray(WPARAM wParam,LPARAM lParam)
{
 if (lParam == WM_LBUTTONDOWN)
 {
  ShowWindow(SW_RESTORE);
 }
 else if (lParam == WM_RBUTTONDOWN)
 {
 // MessageBox("hello");
  CPoint point;
  ::GetCursorPos(&point);
  CMenu *pSubMenu = (CMenu*)m_myMenu.GetSubMenu(0);
  pSubMenu->TrackPopupMenu(TPM_LEFTALIGN|TPM_RIGHTBUTTON,point.x,point.y,
   AfxGetApp()->m_pMainWnd,TPM_LEFTALIGN);
 }
    return TRUE;
}
/********************************************************************************************/