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.
General Control Panel Registry Settings
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.
Standard Control Panel Registry Settings
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" |
Executable Control Panel Registry Settings
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" |
Navigation Control Panel Registry Settings
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. |
Remarks
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
See Also
Reference
Concepts
Control Panel Catalog Items and Sysgen Variables