Windows Classic Home Screen Plug-in Registry Settings

  • Article

4/8/2010

The HKEY_LOCAL_MACHINE\Software\Microsoft\Today\Items registry 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\Items registry 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 Enabled is 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 Enabled is 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 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 0 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 Home 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 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 Type is 0, a reserved plug-in that displays the device owner information is added to the Home screen.

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

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

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

If the value of Type is 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 Options is 0, the Options button is disabled.

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

The following code example shows a registry entry for a plug-in on the Home 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

Concepts

How to: Install and Register a Custom Windows Classic Home Screen Plug-in

Other Resources

Windows Classic Home Screen Plug-ins