minimize into tray

[Now Supported on Windows NT]

Sends a message to the system to add, modify, or delete an icon from the taskbar status area.

WINSHELLAPI BOOL WINAPI Shell_NotifyIcon(

DWORD dwMessage, // message identifier
PNOTIFYICONDATA pnid // pointer to structure
);


Parameters

dwMessage

Identifier of the message to send. This parameter can be one of these values:

NIM_ADD Adds an icon to the status area.
NIM_DELETE Deletes an icon from the status area.
NIM_MODIFY Modifies an icon in the status area.


pnid

Pointer to a NOTIFYICONDATA structure. The content of the structure depends on the value of dwMessage.



Return Values

If the function succeeds, the return value is nonzero.
If the function fails, the return value is zero.

NOTIFYICONDATA

Contains information that the system needs to process taskbar status area messages.

typedef struct _NOTIFYICONDATA { // nid
DWORD cbSize;
HWND hWnd;
UINT uID;
UINT uFlags;
UINT uCallbackMessage;
HICON hIcon;
char szTip[64];
} NOTIFYICONDATA, *PNOTIFYICONDATA;


Members

cbSize

Size of the NOTIFYICONDATA structure.

hWnd

Handle of the window that receives notification messages associated with an icon in the taskbar status area.

uID

Application-defined identifier of the taskbar icon.

uFlags

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

NIF_ICON The hIcon member is valid.
NIF_MESSAGE The uCallbackMessage member is valid.
NIF_TIP The szTip member is valid.


uCallbackMessage

Application-defined message identifier. The system uses the specified identifier for notification messages that it sends to the window identified by hWnd whenever a mouse event occurs in the bounding rectangle of the icon.

hIcon

Handle of the icon to add, modify, or delete.

szTip

Tooltip text to display for the icon.