PluginEvent

4/8/2010

The PluginEvent structure specifies one of the enumerators from the PluginEventID enumeration.

Syntax

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

idEvent
One of the enumerators from the PluginEventID enumeration. The PluginEventID enumeration 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_SYSCOLORCHANGE message 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_KEYDOWN enumerator).