Shell_NotifyIcon(系统托盘图标API函数)详解(转) - 独奏- 博客园
Shell_NotifyIcon是windows中用来生成系统托盘图标的API函数。

一、原型

dephi声明如下:

function Shell_NotifyIcon(dwMessage: DWORD; lpData: PNotifyIconData): BOOL; stdcall;


二、参数及返回值说明
1.dwMessage:[输入参数] 说明要执行的动作。动作的可选值如下:
    NIM_ADD 增加一个图标到托盘区 
    NIM_DELETE 从托盘区删除一个图标
    NIM_MODIFY 修改图标
    NIM_SETFOCUS 将焦点(Focus)返回托盘区。这个消息通常在托盘区图标完成了用户界面下的操作后发出。比如一个托盘图标显示了一个快捷菜单,然后用户按下ESC键了操作,这时使用NIM_SETFOCUS将焦点继续保留在托盘区。该项仅在系统外壳与常用控制DLL( Shlwapi.dll与Comctl32.dll)5.0以上版本才可用。
    NIM_SETVERSION 指定使用特定版本的系统外壳与常用控制DLL。缺省值为0,表示使用Win95方式。该项仅在系统外壳与常用控制DLL 5.0以上版本才可用。
2.lpdata:[输入参数] 一个指向NOTIFYICONDATA结构的指针。
  结构的说明如下:
 


 typedef struct _NOTIFYICONDATA {
    DWORD cbSize;
    HWND hWnd;
    UINT uID;
    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 托盘图标的提示字符串。
  注意:以下数据成员xx系统外壳与常用控制DLL 5.0及以上版本才有效!
  dwState 图标的状态:NIS_HIDDEN-隐藏,或NIS_SHAREDICON-可视。
  dwStateMask 图标状态掩码,用以设置dwState
  szInfo 气球型提示(Balloon ToolTip)的字符串。
  uTimeout 以毫秒计的提示显示时间
  uVersion 确定所依赖的版本。0-Win95,NOTIFYICON_VERSION-Win2000
  szInfoTitle 气球型提示的标题
  dwInfoFlags 设置气球型提示所用的图标(类似MessageBox中所使用的图标):

    NIIF_ERROR   错误
    NIIF_INFO    信息
    NIIF_NONE    没有图标
    NIIF_WARNING  警告
    NIIF_ICON_MASK 6.0版本保留
    NIIF_NOSOUND  限6.0版本,不播放对应的声音
 
  guidItem 6.0版本保留

用delphi 声明如下:


NOTIFYICONDATA = record
    cbSize: DWORD;
    Wnd: HWND;
    uID: UINT;
    uFlags: UINT;
    uCallbackMessage: UINT;
    hIcon: HICON;
    szTip: 
array [0..127of AnsiChar;
    dwState: DWORD;
    dwStateMask: DWORD;
    szInfo: 
array [0..255of AnsiChar;
    uTimeoutOrVersion: UINT;
    szInfoTitle: 
array [0..63of AnsiChar;
    dwInfoFlags: DWORD;
  
end;

 

 3.返回值:成功时函数返回TRUE,否则FALSE。


在delphi的ShellAPI单元中对该函数及其相关消息、常数都进行了声明和定义,但是不同版本会有不同声明和定义。

郑重声明:资讯 【Shell_NotifyIcon(系统托盘图标API函数)详解(转) - 独奏- 博客园】由 发布,版权归原作者及其所在单位,其原创性以及文中陈述文字和内容未经(企业库qiyeku.com)证实,请读者仅作参考,并请自行核实相关内容。若本文有侵犯到您的版权, 请你提供相关证明及申请并与我们联系(qiyeku # qq.com)或【在线投诉】,我们审核后将会尽快处理。
—— 相关资讯 ——