Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
4/8/2010

The PluginEventstructure specifies one of the enumerators from the PluginEventIDenumeration.

Syntax 

typedef struct _PluginEvent {
  PluginEventID 
idEvent;
  PluginEventParametersUnion 
p;
} PluginEvent;

Members

idEvent

One of the enumerators from the PluginEventIDenumeration. The PluginEventIDenumeration is defined in the following table.

Enumeration Description

PE_ACTION

Sent when the plug-in is selected and the user presses the Action key on the device (for example, the middle key on the navigation pad).

PE_DATACHANGE

Sent when there is a signal strength change, battery level change or time-minute change in the plug-in. If the plug-in needs to be redrawn, call IHomePluginEnvironment::InvalidatePlugin.

PE_KEYDOWN

Sent when the user presses a key that the Home screen does not handle. The user can receive events only for the Left/Right controls.

PE_PAINT

Sent when the plug-in needs to be painted on the Home screen.

PE_SYSCOLORCHANGE

Sent when a WM_SYSCOLORCHANGEmessage is broadcast to the system. This message indicates that a change has been made to the color settings on the device.

PE_TIMER

Sent in response to a call to IHomePluginEnvironment::SetSingleShotTimer. Use timer events sparingly because they prevent the device from entering a battery conservation mode.
p

Finds the key that the user pressed (by using the value of the PE_KEYDOWNenumerator).

Requirements

Header home.h
Windows Embedded CE Windows CE 3.0 and later
Windows Mobile Smartphone 2002 and later

See Also