系统托盘图标

 

使用该函数发送dwMessage指定的消息给系统，来增加、修改或删除一个图标在状态栏区域。

BOOL Shell_NotifyIcon(

    DWORD dwMessage,

    PNOTIFYICONDATA pnid

);     

参数：

dwMessage，指定要发送给系统的消息，它可以是下面的值之一：

      NIM_ADD：       添加一个图标到状态栏区域。

      NIM_MODIFY：    修改状态栏区域的图标。

NIM_DELETE：    从状态栏区域删除一个图标。

NIM_SETVERSION：指示任务栏按照相应的动态库版本工作。

      NIM_SETFOCUS：  使焦点返回到状态栏通知区域。当结束托盘图标操作时，任务栏图标必须用此消息。例如，如果任务栏图标正显示上下文菜单，但用户按下"ESCAPE"键取消操作，这时就必须用此消息将焦点返回到任务栏通知区域。

pnid

指向NOTIFYICONDATA结构变量，指定给系统：处理任务栏区域区域所需的信息。NOTIFYICONDATA结构：

typedef struct _NOTIFYICONDATA { // SHELLAPI.H

  DWORD cbSize; 

  HWND hWnd;   

  UINT uID;     

  UINT uFlags;           

  UINT uCallbackMessage; 

  HICON hIcon;       

  CHAR szTip[64]; 

} NOTIFYICONDATA;

成员：

cbSize

结构大小；

hWnd

指定接收系统发来uCallbackMessage指定的自定义消息的窗口；

uID

图标资源ID号；

uFlags

指定结构中的哪些成员是有效的，可以是下列标识组合：

NIF_ICON	hIcon 成员有效
NIF_MESSAGE	uCallbackMessage成员有效.
NIF_TIP	szTip成员有效

uCallbackMessage

指定hWnd窗口接收的自定义消息值。当在托盘上的图标范围矩形中触发鼠标事件时，系统发送这个指定消息hWnd窗口。（消息的wParam参数为uID值【图标资源ID号】，lParam参数为在图标上引发的鼠标消息【如:WM_LBUTTONDOWN】）

hIcon

指定要增加、修改或删除的图标句柄；

szTip

指定鼠标停留在图标上时，出现的提示文本（可以使用’\n’进行多行文字排版）。