Shell_NotifyIcon (Windows CE 5.0)

Windows CE 5.0
Send Feedback

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

Syntax

WINSHELLAPI BOOL WINAPI Shell_NotifyIcon(
  DWORD dwMessage, 
  PNOTIFYICONDATA pnid 
);

Parameters

dwMessage
[in] Specifies the message value to send. The following table shows the possible values.
ValueDescription
NIM_ADDAdds an icon to the status area.
NIM_DELETEDeletes an icon from the status area.
NIM_MODIFYModifies an icon in the status area.
pnid
[in] Pointer to a NOTIFYICONDATA structure. The content of the structure depends on the value of dwMessage.

Return Values

Nonzero indicates success. Zero indicates failure.

Code Example

The following code example demonstrates how to use Shell_NotifyIcon.

Note   To make the following code example easier to read, security checking and error handling are not included. This code example should not be used in a release configuration unless it has been modified to include them.
void Shell_NotifyIconExample()
{

    // Add a Shell_NotifyIcon notificaion for PocketPC or Smartphone.
    NOTIFYICONDATA nid = {0};

    nid.cbSize         = sizeof(nid);
    nid.uID            = 100;      // Per WinCE SDK docs, values from 0 to 12 are reserved and should not be used.
    nid.uFlags         = NIF_ICON;
    nid.hIcon          = LoadIcon(g_hInstance, MAKEINTRESOURCE(IDI_SAMPLEICON));

    // Add the notification to the tray.
    Shell_NotifyIcon(NIM_ADD, &nid);

    // Update the notification icon.
    nid.uFlags         = NIF_ICON;
    nid.hIcon          = LoadIcon(g_hInstance, MAKEINTRESOURCE(IDI_SAMPLEICON2));

    Shell_NotifyIcon(NIM_MODIFY, &nid);

    // Remove the notification from the tray.
    Shell_NotifyIcon(NIM_DELETE, &nid);

    return;

}

Requirements

OS Versions: Windows CE 1.0 and later.
Header: Shellapi.h.

See Also

Standard Shell Functions | NOTIFYICONDATA


Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.


Show: