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 the data in the plug-in changes. 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

Smartphone: Windows Mobile 2002 and later
OS Versions: Windows CE 3.0 and later
Header: home.h

See Also

Home Screen API Structures

IHomePlugin::OnEvent

Last updated on Friday, April 22, 2005

© 2005 Microsoft Corporation. All rights reserved.

Send feedback on this topic to the authors.