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;

Members

• 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).

Requirements

See Also

Reference

Home Screen Structures (Windows Mobile Standard)
IHomePlugin::OnEvent