PluginEvent

Send Feedback

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

Pocket PC: None
Smartphone: Smartphone 2002 and later
OS Versions: Windows CE 3.0 and later
Header: home.h

See Also

Home Screen Structures | IHomePlugin::OnEvent

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.