다음을 통해 공유

Configure a Custom Control Panel (Windows Embedded Compact 7)

  • 아티클

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:

Custom Control Panel Options

You have the following options for creating a custom Control Panel in Windows Embedded Compact 7:

  1. Model it on the Windows Control Panel and use some default Windows Embedded Compact 7 control panel items: Users access default Windows Embedded Compact 7 control panel items to set a variety of system-level properties, such as mouse sensitivity, network setup, and desktop color scheme. To set the configuration options that device users can set by using Control Panel, you add configuration functionality to your OS design. Your device Control Panel UI resembles the Windows desktop Control Panel UI.
  2. Use Silverlight for Windows Embedded to create a custom UI: Your device Control Panel UI is based on Silverlight for Windows Embedded. You choose, customize, and create control panel items to include in the Silverlight for Windows Embedded shell for your Windows Embedded Compact 7 powered device. You customize the Control Panel UI for your device by using three types of control panel items:
    1. A standard control panel category page that you can provision by using an XML file and that Configuration Manager can display in the device UI. For more information, see Configuration Manager in Windows Embedded Compact 7 Documentation.
    2. A stand-alone executable file that the control panel item will launch.
    3. A control panel home page or category page that lists all individual control panel items.

Custom Control Panel with a Silverlight-Based UI

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.

Table 1: Control Panel Item SYSGEN Variables

SYSGEN variable Description Dependencies

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

Basic Control Panel Home Page with a Silverlight-Based UI

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.

See Also

  • [[articles:Windows Embedded Compact 7: Add Standard Control Panel Items to a Control Panel Home Page]]
  • [[articles:Windows Embedded Compact 7: Add Custom Control Panel Category Pages to a Control Panel Home Page]]
  • [[articles:Windows Embedded Compact 7: Add Executable Control Panel Items to a Control Panel Home Page]]