Delphi中任务栏状态区的编程<br>http://www.pickweb.com 2000年04月20日 <br><br><br>--------------------------------------------------------------------------------<br><br>西安交通大学 <br>刘明华 <br>---- 在Windows桌面的任务栏上有一个凹陷的区域,其中显示着系统时钟以及一些图标,这个长方形的区域便是Windows的任务栏状态区(taskbar status area)。本文将介绍使用Borland Delphi进行任务栏状态区的编程,即怎样将应用程序的图标显示在任务栏状态区中。 <br><br>---- 实现原理 <br><br>---- 任务栏状态区的图标添加、删除、以及修改是通过Windows API函数Shell_NotifyIcon来实现的,该函数是由Windows的SHELL32.DLL动态联接库提供的。在Delphi中,Shell_NotifyIcon函数是在ShellAPI单元声明的,其 <br><br>---- 函数原型如下: <br><br>---- function Shell_NotifyIcon(dwMessage: DWORD; lpData: PNotifyIconData): BOOL; stdcall; <br><br>---- 其中参数dwMessage的取值决定函数Shell_NotifyIcon所要进行的操作的类型,它的取值可以是以下三者之一: <br><br>---- NIM_ADD(值为0):在任务栏状态区插入一个图标。 <br><br>---- NIM_DELETE(值为1):从任务栏状态区删除一个图标。 <br><br>---- NIM_MODIFY(值为2):修改任务栏状态区的图标、提示信息、或者通知消息。 <br><br>---- 参数lpData 是一个记录类型(结构类型)的指针,记录类型NotifyIconData的定义如下: <br><br>NOTIFYICONDATA = record <br>cbSize: DWORD; <br>Wnd: HWND; <br>uID: UINT; <br>uFlags: UINT; <br>uCallbackMessage: UINT; <br>hIcon: HICON; <br>szTip: array [0..63] of AnsiChar; <br>end; <br><br>---- cbSize:NOTIFYICONDATA记录的大小。 <br>---- Wnd:与此状态区图标相关联的窗口句柄,此窗口将负责处理uCallbackMessage消息。 <br><br>---- uID:程序自定义的状态区图标的标识符。 <br><br>---- uFlags:这个字段指明NOTIFYICONDATA记录中的成员uCallbackMessage、hIcon和szTip这三者的哪些项的值有效。它的取值可以是下列三者的组合(or运算): <br><br>---- NIF_MESSAGE (值为1):uCallbackMessage项包含了有效的信息。 <br><br>---- NIF_ICON(值为2):hIcon项包含了有效的信息。 <br><br>---- NIF_TIP(值为4): szTip项包含了有效的信息。 <br><br>---- uCallbackMessage:程序定义的消息标识符(32位的整数)。当鼠标在状态区图标上移动或者点击(即,发生了鼠标事件)时,操作系统将向Wnd指定的那个窗口发送uCallbackMessage消息。在uCallbackMessage消息中,lParam参数包含了Windows的鼠标消息的类型,而wParam参数则包含了图标标识(即uID)。有效的鼠标消息包括以下几个:WM_LBUTTONDOWN、WM_RBUTTONDOWN、WM_MBUTTONDOWN、WM_LBUTTONUP、WM_RBUTTONUP、WM_MBUTTONUP、WM_MOUSEMOVE、WM_LBUTTONDBLCLK、WM_RBUTTONDBLCLK以及WM_MBUTTONDBLCLK。 <br><br>---- hIcon:指定一个图标句柄。 <br><br>---- szTip:显示在图标上的提示信息(少于63个字符)。 <br><br>---- Delphi中的实现 <br><br>---- 通过上面的介绍中,我们不难看出,任务栏状态区的编程主要是处理两方面的工作:添加、删除、修改图标;以及处理通知消息。对于图标的添加、删除、修改操作,可以通过调用Shell_NotifyIcon函数来实现。而对于自定义的通知消息,我们就应该在消息循环中给予处理了。 <br><br>---- 下面的示例给出了状态区图标的添加、修改和删除操作的例子,以及图标的通知消息的基本处理框架。 <br><br>unit Unit1; <br><br>interface <br><br>uses <br>Windows, Messages, SysUtils, Classes, Graphics, <br>Controls, Forms, Dialogs, ExtCtrls, ShellAPI; <br><br>const <br>WM_TRAYNOTIFY=WM_USER+1;//定义通知消息 <br><br>type <br>TForm1 = class(TForm) <br>Timer1: TTimer; <br>procedure FormCreate(Sender: TObject); <br>procedure Timer1Timer(Sender: TObject); <br>procedure FormDestroy(Sender: TObject); <br>private <br>{ Private declarations } <br>public <br>{ Public declarations } <br>procedure WndProc(var Msg: TMessage); override; <br>end; <br><br>var <br>Form1: TForm1; <br>nd0, nd1:NotifyIconData; <br>hs:array[0..9]of LongWord; <br><br>implementation <br>{$R *.DFM} <br><br>procedure TForm1.FormCreate(Sender: TObject); <br>begin <br>//加载Icon0..Icon9这10个图标资源, <br>并且保存它们的句柄。 <br>//图标Icon0..Icon9分别对应与0..9这9个数字。 <br>hs[0]:=LoadIcon(hInstance, 'Icon0'); <br>hs[1]:=LoadIcon(hInstance, 'Icon1'); <br>hs[2]:=LoadIcon(hInstance, 'Icon2'); <br>hs[3]:=LoadIcon(hInstance, 'Icon3'); <br>hs[4]:=LoadIcon(hInstance, 'Icon4'); <br>hs[5]:=LoadIcon(hInstance, 'Icon5'); <br>hs[6]:=LoadIcon(hInstance, 'Icon6'); <br>hs[7]:=LoadIcon(hInstance, 'Icon7'); <br>hs[8]:=LoadIcon(hInstance, 'Icon8'); <br>hs[9]:=LoadIcon(hInstance, 'Icon9'); <br><br>//填充NotifyIconData记录型变量nd0 <br>nd0.cbSize := sizeof(NotifyIconData); <br>nd0.Wnd := handle; <br>nd0.uID := 0; <br>nd0.uFlags := NIF_MESSAGE or NIF_ICON or NIF_TIP; <br>nd0.uCallbackMessage := WM_TRAYNOTIFY; <br>nd0.hIcon := hs[0]; <br>StrPLCopy(nd0.szTip, 'Hello, World!', 63); <br><br>//填充NotifyIconData记录型变量nd1 <br>nd1.cbSize := sizeof(NotifyIconData); <br>nd1.Wnd := handle; <br>nd1.uID := 1; <br>nd1.uFlags := NIF_MESSAGE or NIF_ICON or NIF_TIP; <br>nd1.uCallbackMessage := WM_TRAYNOTIFY; <br>nd1.hIcon := hs[0]; <br>StrPLCopy(nd1.szTip, 'Simon Loves Daisy', 63); <br><br>//在任务栏状态区添加图标 <br>Shell_NotifyIcon(NIM_ADD, @nd0); <br>Shell_NotifyIcon(NIM_ADD, @nd1); <br>end; <br><br>procedure TForm1.Timer1Timer(Sender: TObject); <br>var <br>st:SystemTime; <br>begin <br>//每秒钟更新一次图标:图标0显示秒数的十位, <br>图标1显示秒数的个位。 <br>GetLocalTime(st); <br>nd0.hIcon := hs[st.wSecond div 10]; <br>nd1.hIcon := hs[st.wSecond mod 10]; <br>//修改任务栏状态区的图标 <br>Shell_NotifyIcon(NIM_MODIFY, @nd0); <br>Shell_NotifyIcon(NIM_MODIFY, @nd1); <br>end; <br><br>procedure TForm1.FormDestroy(Sender: TObject); <br>begin <br>//将图标从任务栏状态区删除 <br>Shell_NotifyIcon(NIM_DELETE, @nd0); <br>Shell_NotifyIcon(NIM_DELETE, @nd1); <br>end; <br><br>//处理 通知消息 <br>procedure TForm1.WndProc(var Msg: TMessage); <br>var <br>IconID:integer; <br>pt:TPOINT; <br>begin <br>if msg.Msg = WM_TRAYNOTIFY then <br>begin <br>{ <br>在通知消息中,wParam参数为图标的uID, <br>lParam参数为鼠标事件的类型。 <br>} <br>iconID := msg.WParam; <br>//获取鼠标的在屏幕上的位置 <br>GetCursorPos(pt); <br><br>//通知消息的处理的基本框架结构如下: <br>case msg.lParam of <br>WM_LBUTTONDOWN: <br>begin <br>//鼠标右键被按下 <br>end; <br>WM_RBUTTONDOWN: <br>begin <br>//鼠标左键被按下 <br>end; <br>WM_LBUTTONUP: <br>begin <br>//释放鼠标左键 <br>end; <br>WM_RBUTTONUP: <br>begin <br>//释放鼠标右键 <br>end; <br>WM_MOUSEMOVE: <br>begin <br>//鼠标在图标上移动 <br>end; <br>WM_LBUTTONDBLCLK: <br>begin <br>//鼠标左键双击 <br>end; <br>WM_RBUTTONDBLCLK: <br>begin <br>//鼠标右键双击 <br>end; <br>end; //end case <br>end <br>else//调用父类的WndProc方法处理其它消息 <br>inherited; <br>end; <br><br>end.