Today Screen Plug-in Registry Settings (PPC Only)

Send Feedback

The HKEY_LOCAL_MACHINE\Software\Microsoft\Today\Items registry key controls the characteristics of a Today Screen plug-in. The following table shows the named values for the HKEY_LOCAL_MACHINE\Software\Microsoft\Today\Items registry key.

Value : type Description
Enabled : DWORD This value controls whether the user can enable or disable a plug-in item on the today screen.

If the value of Enabled is 0, the plug-in does not appear on the Today screen, but the user can open it through the Today control panel.

If the value of Enabled is 1, the plug-in appears on the Today screen, but the user can disable it using the Today control panel.

Order : DWORD This value controls the order of the plug-in on the Today screen.

If the value of Order is 0, the plug-in is the topmost plug-in.

Selectability : DWORD This value enables the selection focus notifications.

If the value of Selectability is zero or does not exist, then the plug-in cannot be selected, and it never receives any notifications.

If the value of Selectability is equal to 1, then the Today screen manages the selection of the item automatically, and does not send any notification messages to the plug-in.

If the value of Selectability is equal to 2, then the Today screen uses the Today Screen selection APIs to track the selection of the current item.

Type : DWORD This value indicates the type of plug-in.

If the value of Type is 0, it indicates a reserved plug-in that displays the device owner information is added to the Today Screen.

If the value of Type is 1, it indicates a reserved plug-in that displays the Appointments is added to the Today Screen.

If the value of Type is 2, it indicates a reserved plug-in that displays the Mail is added to the Today Screen.

If the value of Type is 3, it indicates a reserved plug-in that displays the Tasks is added to the Today Screen.

If the value of Type is 4, a custom plug-in is added to the Today Screen.

Options : DWORD This value controls whether the plug-ins can have an Options dialog that is displayed when the "Options" button is clicked from the Today Screen control panel.

If the value of Options is 0, it means that the Options button is disabled.

If the value of Options is 1, it means that the Options button is enabled.

The following code example shows a registry entry for a plug-in on the Today Screen.

[HKEY_LOCAL_MACHINE\Software\Microsoft\Today\Items\<Your Custom Item Name>]
    "Enabled"=dword:1
    "Order"=dword:3
    "Selectability"=dword:2
    "Type"=dword:1
    "Options"=dword:0

See Also

How to: Install and Register a Custom Today Screen Item

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.