C窗口程序——Shell_NotifyIcon()函数的使用

Shell_NotifyIcon函数使用

1.Shell_NotifyIcon介绍

== Shell_NotifyIcon是Windows中用来生成系统托盘图标的API函数 ==

函数原型：

BOOL Shell_NotifyIcon(
	   DWORD              dwMessage,
	   PNOTIFYICONDATA    lpdata
	   );

参数说明（dwMessage、Ipdata)

1. dwMessage：[输入参数] 说明要执行的动作。动作的可选值如下

NIM_ADD 增加一个图标到托盘区
NIM_DELETE 从托盘区删除一个图标
NIM_MODIFY 修改图标
NIM_SETFOCUS将焦点返回托盘区。这个消息通常在托盘区完成了用户界面下的操作后发出。比如一个托盘图标显示一个快捷菜单，然后用户按下ESC键了操作，这是使用NIM_SETFOCUS将焦点继续保留在托盘区。这项仅在系统外壳与常用控制DLL5.0版本以上才可以使用。
NIM_SETVERSION 指定使用特定版本的系统的外壳与常用控制DLL。缺省值为0，表示使用win95方式。该项仅在系统外壳与常用控制DLL5.0以上版本才能用。

  2.lpdata：【输入参数】 一个指向NOTUFYICONDATA结构的指针。
	结构说明如下：

	typedef struct _NOTIFYICONDATA {
	DWORD     cbSize;
	HWND      hWND;
	UINT      uFlags;
	UINT      uCallbackMessage;
	HICON     hIcon;
	TCHAR     szTip[64];
	DWORD     dwState;
	DWORD     dwStateMask;
	TCHAR     szInfo [256];
	union {
		   UINT 	uTimeout;
		   UINT 	uVersion;
	  };
	TCHAR     szInfoTitle[64];
	DWORD     dwInfoFlags;
	GUID      guidItem;
	} NOTIFYICONDATA, *PNOTIFYICONDATA;

cbSize 以字节记的结构大小，以适应不同版本。
hWnd 接收Windows消息的窗口句柄。
uID 托盘图标的ID
uFlags 指示结构中的哪些成员包含有效数据，可选值： NIF_ICON, NIF_MESSAGE,NIF_TIP,NIF_STATE, NIF_INFO, NIF_GUID.
uCallbackMessage 回调消息ID， 由用户自定义。与一个自定义的消息处理函数关联。
hIcon 托盘图标句柄。
szTip 托盘图标的提示字符串。
注意：以下数据成员仅限系统外壳与常用控制DLL5.0及以上版本才有效。
dwState 图标的状态：NIS_HIDDEN-隐藏， 或NIS_SHAREDICON-可视。
dwStateMask 图标状态掩码，用以设置dwState
szInfo 气球型提示 （Balloon ToolTip） 的字符串。
uTimeout 以毫秒计的提示显示时间
uVersion 确定所依赖的版本。 0-Win95， NOTIFYICON_BERSION-Win2000
SzInfoTitle 气球型提示的标题
dwInfoFlags 设置气球型提示所用的图标（类似MessageBox中所使用的图标）：
 	NIIF_ERROR  错误
	NIIF_INFO 信息
	NIIF_NONE 没有图标
	NIIF_WARNING 警告
	NIIF_ICON_MASK 6.0版本保留
	NIIF_NOSOUND 限6.0版本， 不播放对应的声音
guidItem 6.0版本保留

使用思路：

本人是在点击窗口最小化中事件中添加此函数，例如我点击最小化，然后再托盘处产生了一个程序图标。
1.先定义一个全局的变量：
NOTIFYICONDATA　e

2.然后在适当的位置对e进行初始化，我是在主窗口的 while (GetMessage (&msg, NULL, 0, 0)) 语句之前初始化的。

3.最后在最小化处添加函数：Shell_NotifyIcon(NIM_ADD, &e);

详细代码见下（亲测）：

#include <windows.h>  
#include <tchar.h>  
#include "ShellAPI.h"  
#include "resource1.h"  
#include <string.h>

#define WM_IAWENTRAY    WM_USER+5  //系统托盘的自定义消息  

//定义全局变量  
HINSTANCE g_hInst;
NOTIFYICONDATA e;

LRESULT CALLBACK WndProc(HWND, UINT, WPARAM, LPARAM);

int WINAPI WinMain(HINSTANCE hInstance, HINSTANCE hPrevInstance,
	PSTR szCmdLine, int iCmdShow)
{
	g_hInst = hInstance; //获取该程序实例句柄  

	static TCHAR szAppName[] = TEXT("TimeWork");
	HWND         hwnd;
	MSG          msg;
	WNDCLASS     wndclass;

	wndclass.style = CS_HREDRAW | CS_VREDRAW;
	wndclass.lpfnWndProc = WndProc;
	wndclass.cbClsExtra = 0;
	wndclass.cbWndExtra = 0;
	wndclass.hInstance = hInstance;
	wndclass.hIcon = LoadIcon(NULL, IDI_APPLICATION);
	wndclass.hCursor = LoadCursor(NULL, IDC_ARROW);
	wndclass.hbrBackground = (HBRUSH)GetStockObject(WHITE_BRUSH);
	wndclass.lpszMenuName = NULL;
	wndclass.lpszClassName = szAppName;

	if (!RegisterClass(&wndclass))
	{
		MessageBox(NULL, TEXT("This program requires Windows NT!"),
			szAppName, MB_ICONERROR);
		return 0;
	}

	hwnd = CreateWindow(szAppName,                  // window class name  
		TEXT("托盘程序"), // window caption  
		WS_OVERLAPPEDWINDOW,        // window style  
		CW_USEDEFAULT,              // initial x position  
		CW_USEDEFAULT,              // initial y position  
		CW_USEDEFAULT,              // initial x size  
		CW_USEDEFAULT,              // initial y size  
		NULL,                       // parent window handle  
		NULL,                       // window menu handle  
		hInstance,                  // program instance handle  
		NULL);                     // creation parameters  

	ShowWindow(hwnd, iCmdShow);
	UpdateWindow(hwnd);

	//初始化NOTIFYICONDATA结构  
	e.cbSize = sizeof(NOTIFYICONDATA);
	e.hWnd = hwnd;
	e.uID = IDI_ICON1;
	e.uFlags = NIF_ICON | NIF_MESSAGE | NIF_TIP;
	e.uCallbackMessage = WM_IAWENTRAY;
	e.hIcon = LoadIcon(g_hInst, MAKEINTRESOURCE(IDI_ICON1));
	strcpy_s(e.szTip,20,"我太难了！"); //添加的托盘提示符字符串，鼠标放在托盘处会显示提示文字
//	_tcscpy(e.szTip, TEXT("TimeWork正在工作！\r\n点击打开主界面")); //_tcscpy是windows宏，需包含头文件tchar.h  

	while (GetMessage(&msg, NULL, 0, 0))
	{
		TranslateMessage(&msg);
		DispatchMessage(&msg);
	}
	return msg.wParam;
}

LRESULT CALLBACK WndProc(HWND hwnd, UINT message, WPARAM wParam, LPARAM lParam)
{
	HDC         hdc;
	PAINTSTRUCT ps;
	RECT        rect;

	switch (message)
	{
	case WM_CREATE:
		return 0;

	case WM_PAINT:
		hdc = BeginPaint(hwnd, &ps);

		GetClientRect(hwnd, &rect);

		DrawText(hdc, TEXT("Hello, my fridents！"), -1, &rect,
			DT_SINGLELINE | DT_CENTER | DT_VCENTER);

		EndPaint(hwnd, &ps);
		return 0;

	case WM_IAWENTRAY:
		if (wParam == IDI_ICON1) {
			if (lParam == WM_LBUTTONDOWN) {
				//还可以在这个地方加入一个菜单，鼠标右键单击时显示  
				ShowWindow(hwnd, SW_SHOWNORMAL);
				return TRUE;
			}
		}
		return FALSE;
	case WM_SYSCOMMAND:
		switch (wParam)
		{
		case SC_CLOSE:
			DestroyWindow(hwnd);
			PostQuitMessage(0);
			break;
		case SC_MINIMIZE:
			ShowWindow(hwnd, SW_HIDE);
			Shell_NotifyIcon(NIM_ADD, &e); //最小化时隐藏窗口并设置系统托盘  
			break;
		}
		return 0;

	case WM_DESTROY:
		Shell_NotifyIcon(NIM_DELETE, &e);
		PostQuitMessage(0);
		return 0;
	}
	return DefWindowProc(hwnd, message, wParam, lParam); 

}

具体工程文件见：https://download.csdn.net/download/sf9090/11884292
注意：其中图标资源自行添加
不会添加资源的见大牛博客：https://blog.csdn.net/nullccc/article/details/81352470
本文参考：https://www.cnblogs.com/duzouzhe/archive/2010/04/08/1707050.html
https://blog.csdn.net/say_high/article/details/11092961