Share via


SHNOTIFICATIONDATA (Windows Embedded CE 6.0)

1/6/2010

This structure contains icon notification data.

Syntax

typedef struct _SHNOTIFICATIONDATA{
  DWORD cbStruct;
  DWORD dwID;
  SHNP npPriority;
  DWORD csDuration;
  HICON hicon;
  DWORD grfFlags;
  CLSID clsid;
  HWND hwndSink;
  LPCTSTR pszHTML;
  LPCTSTR pszTitle;
  LPARAM lParam;
  union
  {
    SOFTKEYMENU skm;
    SOFTKEYNOTIFY rgskn[NOTIF_NUM_SOFTKEYS];
  }
  LPCTSTR pszTodaySK;
  LPCTSTR pszTodayExec;
} SHNOTIFICATIONDATA;

Members

  • cbStruct
    Size of the structure, in bytes, used for verification and versioning.
  • dwID
    Identifier for this particular notification.
  • npPriority
    Priority for the notification, given by the SHNP enumeration.
  • csDuration
    Duration of the notification. The usage depends on the value of npPriority. Time is in seconds. A value of -1 indicates infinite duration; that is, the notification remains until the user dismisses it, for example, with required user input keystrokes.
  • hicon
    Handle to the icon for the notification.
  • grfFlags
    Determines which members in the structure are valid or active. The following table shows the possible flag values.

    Flag Description

    SHNF_ALERTONUPDATE

    Physical alerts are replayed when there is an update to the notification.

    SHNF_CRITICAL

    The border and title of the notification are highlighted.

    SHNF_DISPLAYON

    The display is forced to turn on for the notification.

    SHNF_FORCEMESSAGE

    The notification is forced to display, regardless of Settings.

    SHNF_HASMENU

    The softkey bar is created from an HMENU passed in skm structure.

    SHNF_SHNF_SPINNERS

    The notification can be stacked.

    SHNF_SILENT

    The notification is forced to be silent and not vibrate, regardless of Settings.

    SHNF_STRAIGHTTOTRAY

    The notification is not displayed when it is initially added. The icon will display for csDurationseconds and will then go straight to the tray. The user can view the icon to see the notification by opening the tray.

    SHNF_TITLETIME

    The current time is displayed with the notification title.

    SHNF_WANTVKTTALK

     

  • clsid
  • hwndSink
    Handle to the window to receive command choices, dismiss, and so on.
  • pszHTML
    HTML content for the notification bubble.
  • pszTitle
    String that contains the optional title for notification bubble.
  • lParam
    User-defined parameter.

Requirements

Header aygshell.h
Library aygshell.lib
Windows Embedded CE Windows Embedded CE 6.0 and later

See Also

Reference

AYGShell Structures
SHNotificationGetData

Other Resources