Windows Classic Home Screen Plug-in Selection

4/8/2010

The ability to navigate Windows Classic Home screen plug-ins using the hardware keypad was introduced in Windows Mobile 2003 Second Edition.

Note

This section applies to the Windows Classic Home Screen Overview and not the new Windows Default Home Screen Overview.

The Windows Mobile Professional and Windows Mobile Classic Windows Classic Home screen can be operated with one hand and without the stylus. Because of this feature, Windows Classic Home screen items now receive selection notification messages. These messages are analogous to the WM_SETFOCUS and WM_KILLFOCUS messages that Windows Mobile software sends to child window controls. This section describes how to notify Windows Classic Home screen plug-ins of these notifications.

Windows Mobile software automatically handles the selection of Windows Classic Home screen plug-ins that have not been updated to support selection focus notifications. If you have plug-ins that have a response dependent on a screen tap, you must update your plug-ins to support selection focus notifications.

Note

All the messages defined in this section are included in the todaycmn.h header file.

In This Section

• Receiving the Selection Focus
  Describes the WM_TODAYCUSTOM_RECEIVEDSELECTION and TODAYM_DRAWWATERMARK messages.

• Taking the Selection Focus
  Describes the TODAYM_TOOKSELECTION message.

• Receiving Keypad Presses
  Describes the action and navigation messages.

• Losing the Selection Focus
  Describes the WM_TODAYCUSTOM_LOSTSELECTION message.

• Drawing the Windows Classic Home Screen Watermark
  Describes the TODAYM_DRAWWATERMARK message.