Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
4/8/2010

The HKEY_LOCAL_MACHINE\Software\Microsoft\Today\Itemsregistry key controls the characteristics of a Windows Classic Home screen plug-in.

Note:
This section applies to the Windows Classic Home screen and does not apply to the new Windows Default Home screen.

The following table shows the named values for the HKEY_LOCAL_MACHINE\Software\Microsoft\Today\Itemsregistry key.

Name Type Description

Enabled

DWORD

This value controls whether the user can enable or disable a plug-in item on the Home screen.

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

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

Order

DWORD

This value controls the order of the plug-in on the Home screen.

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

Selectability

DWORD

This value enables the selection focus notifications.

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

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

If the value of Selectabilityis equal to 2, then the Home screen uses the Home 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 Typeis 0, a reserved plug-in that displays the device owner information is added to the Home screen.

If the value of Typeis 1, a reserved plug-in that displays the Appointments is added to the Home screen.

If the value of Typeis 2, a reserved plug-in that displays the Mail is added to the Home screen.

If the value of Typeis 3, a reserved plug-in that displays the Tasks is added to the Home screen.

If the value of Typeis 4, a custom plug-in is added to the Home 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 Home screen control panel.

If the value of Optionsis 0, the Options button is disabled.

If the value of Optionsis 1, the Options button is enabled.

The following code example shows a registry entry for a plug-in on the Home screen.

Copy Code 
[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