Control Panel Registry Settings (Compact 2013)

3/28/2014

The control panel application framework in Windows Embedded Compact supports creation of a custom control panel in your device shell to support configuration and customization of system-wide properties and settings. The control panel feature uses registry information to launch and display custom control panel icon, executable, and XML files.

The OEM implements a control panel in one of three ways:

  • As a standard control panel that may be provisioned by an XML file and displayed by the Configuration Manager.
  • As a stand-alone executable that will be launched by the Control Panel module.
  • As a navigation panel that contains a list of individual control panels.

You can configure standard control panel-related settings by using the following entries, located in the key HKEY_LOCAL_MACHINE\Software\Microsoft\Settings\<controlpanelguid>

where <controlpanelguid> is the GUID of your control panel.

Name

Type

Description

Sample value

(Default)

REG_SZ

Specifies the name of your control panel. This is the name that will be displayed in the UI.

"Sound"

Title

REG_MUI_SZ

Specifies the title of your control panel.

mui_sz:"SndSchemeCpl.cpl,#400" or "Sound Panel"

Type

REG_DWORD

Specifies the type of your control panel.

0×00000000 indicates the control panel is an individual control panel provisioned by an XML file and invoked by an appropriate Configuration Service Provider.

XMLCPLProc

REG_SZ

String specifying the path of the control panel binary that will be processed by the Configuration Manager.

"\windows\SndSchemeCpl.cpl"

Location

REG_SZ

String specifying the path of the control panel XML that will be processed by the Configuration Manager.

"\windows\Microsoft.SndScheme.cpl.xml"

Icon

REG_SZ

Specifies the path of the icon to use to represent the control panel in the UI.

"\windows\CtlPnl2_Sound.png"

You can configure executable control panel-related settings by using the following entries, located in the key HKEY_LOCAL_MACHINE\Software\Microsoft\Settings\<controlpanelguid>

where <controlpanelguid> is the GUID of your control panel stand-alone executable.

Name

Type

Description

Sample value

(Default)

REG_SZ

Specifies the name of your control panel. This is the name that will be displayed in the UI.

"Wi-Fi"

Title

REG_MUI_SZ

Specifies the title of your control panel.

mui_sz:"WiFiCpl.exe,#400" or "WiFi Panel"

Type

REG_DWORD

Specifies the type of your control panel.

0×00000001 indicates the control panel is an executable.

Location

REG_SZ

String specifying the relative path of the executable file.

"\windows\WiFiCpl.exe"

Icon

REG_SZ

Specifies the path of the icon to use to represent the control panel in the UI.

"\windows\CtlPnl2_WIFI.png"

You can configure navigation control panel-related settings by using the following entries, located in the key HKEY_LOCAL_MACHINE\Software\Microsoft\Settings\<controlpanelguid>

where <controlpanelguid> is the GUID of your navigation control panel.

Name

Type

Description

Sample value

(Default)

REG_SZ

Specifies the name of your control panel. This is the name that will be displayed in the UI.

"Settings main window"

Title

REG_SZ

Specifies the title of your control panel.

"Settings main window"

Type

REG_DWORD

Specifies the type of your control panel.

0×00000002 indicates the control panel is a navigation panel.

XAML

REG_SZ

Specifies the path of the XAML file to use to represent the navigation panel in the UI.

"\windows\Microsoft.MainNavCPL.xaml"

You can configure individual control panels for display in the navigation panel by listing them in values under the key HKEY_LOCAL_MACHINE\Software\Microsoft\Settings\<controlpanelguid>\SecureItems

where <controlpanelguid> is the GUID of your navigation control panel.

Name

Type

Description

Sample value

(Default)

REG_SZ

Value not set

"Settings main window"

<GUIDofControlPanel>

REG_ DWORD

Specifies the position of the control panel specified by the GUID.

0×00000010 (16) indicates the control panel is at the top of navigation panel.

<GUIDofControlPanel>

REG_ DWORD

Specifies the position of the control panel specified by the GUID.

0×00000020 (32) indicates the control panel is next to the top of navigation panel.

The following examples, taken from %_WINCEROOT%\PUBLIC\WCESHELLFE\OAK\CTLPNL2\FILES\WCESHELLFE.REG,

show how to set registry values for the CtlPnl2 application framework from a .reg file.

The following settings configure a Wi-Fi control panel and a Bluetooth control panel as executables.

[HKEY_LOCAL_MACHINE\Software\Microsoft\Settings\{2E54B5FC-6E98-4e30-AD3D-9617FE295F02}]

@="WiFi"

"Title"=mui_sz:"WiFiCpl.exe,#400"

"Type"=dword:1

"Location"="\\windows\\WiFiCpl.exe"

"Icon"="\\windows\\CtlPnl2_WIFI.png"

[HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Settings\{297E4050-91BC-4E5A-B081-5F78D8260A91}]

@="Bluetooth"

"Title"="Bluetooth"

"Type"=dword:1

"Location"="\\windows\\bthsettings.exe"

"Icon"= "\\windows\\CtlPnl2_Bthsettings.png"

The following settings configure a Date and Time panel and a Sound panel as individual control panels.

[HKEY_LOCAL_MACHINE\Software\Microsoft\Settings\{9CB05CAE-D2CF-4409-8E64-352DD8F6FDE2}]

@="Date and Time"

"Title"=mui_sz:"DateTimeCpl.cpl,#400"

"Type"=dword:0

"XMLCPLProc"="\\windows\\DateTimeCpl.cpl"

"Location"="\\windows\\Microsoft.DateTime.cpl.xml"

"Icon"="\\windows\\CtlPnl2_DateTime.png"

[HKEY_LOCAL_MACHINE\Software\Microsoft\Settings\{174A20F6-2799-41f1-A3FA-E5B7AB10D1DF}]

@="Sound"

"Title"=mui_sz:"SndSchemeCpl.cpl,#400"

"Type"=dword:0

"XMLCPLProc"="\\windows\\SndSchemeCpl.cpl"

"Location"="\\windows\\Microsoft.SndScheme.cpl.xml"

"Icon"="\\windows\\CtlPnl2_Sound.png"

The following settings configure a navigation panel that contains the above control panels.

[HKEY_LOCAL_MACHINE\Software\Microsoft\Settings\{01608162-D728-4009-BDA4-3DB8585E577D}]

@="Settings main window"

"Title"="Settings main window"

"Type"=dword:2

"XAML"="\\windows\\Microsoft.MainNavCPL.xaml"

[HKEY_LOCAL_MACHINE\Software\Microsoft\Settings\{01608162-D728-4009-BDA4-3DB8585E577D}\SecureItems]

"{9CB05CAE-D2CF-4409-8E64-352DD8F6FDE2}"=dword:10

"{297E4050-91BC-4E5A-B081-5F78D8260A91}"=dword:20

"{2E54B5FC-6E98-4e30-AD3D-9617FE295F02}"=dword:30

"{174A20F6-2799-41f1-A3FA-E5B7AB10D1DF}"=dword:40

Show: