Control Panel is a central location in the user interface (UI) that has small applications that you use to set system-level properties and parameters for the OS and other applications. An OS control panel can contain standard control panel items included in Windows Embedded Compact 7, in addition to custom control panel items. In this article:
You have the following options for creating a custom Control Panel in Windows Embedded Compact 7:
Device users can access Control Panel by using a UI that is based on Silverlight for Windows Embedded. You select this option by including the catalog items for Control Panel (SYSGEN_CTLPNL2) and Silverlight for Windows Embedded (SYSGEN_XAML_RUNTIME) in your OS design.
In the simplest case, you select control panel items to include in your Control Panel UI from default Windows Embedded Compact 7 control panel items. To do this, include SYSGEN variables from Table 1 in your OS design to configure in your Control Panel UI.
SYSGEN_DATETIMECPL
Provides a UI for the user to set the device time zone, date, and time.
Requires SYSGEN_CTLPNL2 and SYSGEN_SYSCSPS_CLOCKCSP. For more information, see Device Management Catalog Items in Windows Embedded Compact 7 Documentation.
SYSGEN_DISPLAYCPL
Provides a UI for the user to select the device wallpaper image, select a theme, and configure the backlight settings.
Requires SYSGEN_CTLPNL2, SYSGEN_SYSCSPS_DISPLAYCSP, SYSGEN_IMAGING, SYSGEN_IMAGING_JPG_ENCODE, SYSGEN_IMAGING_PNG_DECODE, and SYSGEN_IMAGING_BMP_DECODE. For more information, see Device Management Catalog Items in Windows Embedded Compact 7 Documentation.
SYSGEN_REGIONALCPL
Provides a UI for the user to change the device locale, display language, and regional format. The latter includes number, currency, time, date, and calendar settings.
Requires SYSGEN_CTLPNL2 and SYSGEN_SYSCSPS_LOCALECSP. For more information, see Device Management Catalog Items in Windows Embedded Compact 7 Documentation.
SYSGEN_SNDSCHEMECPL
Provides a UI for the user to select ringtones, a clock alarm, and new message alerts. The user can change sound for events, including vibrate and silent, for new mail, sent mail, screen taps, and calendar alerts.
Requires SYSGEN_CTLPNL2, SYSGEN_SYSCSPS_SNDSCHEMECSP, and SYSGEN_AUDIO_STDWAVEFILES. For more information, see Device Management Catalog Items in Windows Embedded Compact 7 Documentation.
SYSGEN_WIFICPL
Provides a UI for the user to connect to a Wi-Fi network, add a network, and configure network properties such as signal strength, connection status, and secure mode.
Requires SYSGEN_CTLPNL2, SYSGEN_ETH_80211_NWIFI, and SYSGEN_CONNMGR2. For more information, see Device Management Catalog Items in Windows Embedded Compact 7 Documentation.
SYSGEN_ETHERNETCPL
Provides a UI for the user to connect to an Ethernet network, add a network, and configure network properties.
Requires SYSGEN_CTLPNL2. For more information, see Networking Catalog Items in Windows Embedded Compact 7 Documentation.
SYSGEN_INPUTCPL
Provides a UI for the user to configure the default input language.
Requires SYSGEN_CTLPNL2, SYSGEN_IE7_SHLWAPI, and SYSGEN_XAMLIM.
IMG_SCREEN_SMALL
Provides a UI for a device with a small-size display screen. If IMG_SCREEN_SMALL is not set to 1, the device uses a UI design for a medium-size screen.
None
When you add the SYSGEN_CTLPNL2 catalog item to your OS design, the OS automatically sets up registry entries for a basic control panel home page. The source code that does this is located in the file %_WINCEROOT%\public\wceshellfe\oak\files\wceshellfe.reg.
The code that the OS executes to create the basic control panel home page when you build your OS design looks like the following:
;----------------------------start CONTROL PANEL 2 (Settings) ------------------------ ; Main Navigation CPL [HKEY_LOCAL_MACHINE\Software\Microsoft\Settings\{01608162-D728-4009-BDA4-3DB8585E577D}] @="Settings main window" "Title"="Settings main window" "Type"=dword:2 [HKEY_LOCAL_MACHINE\Software\Microsoft\Settings\{01608162-D728-4009-BDA4-3DB8585E577D}\SecureItems]
This control panel item type is set to 2, which indicates that it is a control panel home page. For type 2 control panel items, you must also specify an application title. The source code for the control panel home page is located at %_WINCEROOT%\public\wceshellfe\oak\ctlpnl2\exe\cplframe.cpp and the XAML files that describe the default visual appearance are in %_WINCEROOT%\public\wceshellfe\oak\CtlPnl2\Exe\Resources\Dll_Mid\Xaml. If you include the small display size SYSGEN variable (IMG_SCREEN_SMALL) in your OS, the visual appearance is specified in %_WINCEROOT%\public\wceshellfe\oak\CtlPnl2\Exe\Resources\Dll\Xaml.
When you add the SYSGEN variables for control panel items, the OS includes registry entries to place these items, with their default icons and functionality, on the control panel home page. You must add at least one control panel item to make the control panel home page UI visible when you start Control Panel.
Wendy Giberson edited Revision 2. Comment: Moved "Windows Embedded Compact 7" to the end of the title.