Edit

Share via

desktop7:ControlPanelItem

  • Article

Registers an extension as a control panel item.

Element hierarchy

<Package>

    <Applications>

         <Application>

              <Extensions>

                   <desktop7:Extension>

                        <desktop7:ControlPanelItem>

Syntax

<desktop7:ControlPanelItem
    Name = 'A string with a value between 1 and 32767 characters in length with a non-whitespace character at its beginning and end.'
    SystemApplicationName = 'A string with a value between 1 and 32767 characters in length with a non-whitespace character at its beginning and end.'
    SystemControlPanelCategory = 'A string with a value between 1 and 32767 characters in length with a non-whitespace character at its beginning and end.'
    SystemSoftwareTasksFileUrl = 'A string with a value between 1 and 32767 characters in length with a non-whitespace character at its beginning and end.'
    Clsid = 'A GUID in the form xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.' >

    desktop7:DefaultIcon
    desktop7:LocalizedString
    desktop7:InfoTip

</desktop7:ControlPanelItem>

Attributes and elements

Attributes

Attribute Description Data type Required Default value
Name A descriptive name of the Shell extension. This value is not actually used directly by the system but makes it easier to read the entry in the registry. A string with a value between 1 and 32767 characters in length with a non-whitespace character at its beginning and end. Yes
SystemApplicationName The canonical name of the item. The command of form control.exe /name [System.ApplicationName] opens the item. A string with a value between 1 and 32767 characters in length with a non-whitespace character at its beginning and end. Yes
SystemControlPanelCategory A value that declares the control panel categories where the item appears. Multiple categories are separated by commas. For more information see Assigning Control Panel Categories A string with a value between 1 and 32767 characters in length with a non-whitespace character at its beginning and end. Yes
SystemSoftwareTasksFileUrl The path of the XML file that defines task links. This provides a sub-list of items underneath this Control Panel Item, when Control Panel is viewed in the “Category” mode. A string with a value between 1 and 32767 characters in length with a non-whitespace character at its beginning and end. Yes
Clsid The Clsid of the COM class that implements the Shell Extension. A GUID in the form xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx. Yes

Child elements

Child element Description
desktop7:DefaultIcon Specifies the icon to show for the item in the Control Panel.
desktop7:LocalizedString Specifies the localized string to show for the item in the Control Panel.
desktop7:InfoTip Specifies the Infotip string to show when the mouse hovers over the item’s icon.

Parent elements

Parent element Description
Extension Defines an extensibility point for the application.

Requirements

Item Value
Namespace http://schemas.microsoft.com/appx/manifest/desktop/windows10/7
Minimum OS Version Windows 10 (Build 19645)