Configuring the Desktop Background on a Thin Client (Windows Embedded CE 6.0)

1/5/2010

You can configure the desktop background on a thin client by editing registry settings.

Select a Custom Desktop Background

The desktop background, also known as wallpaper, is a background picture displayed on the desktop of a thin client. The default background includes a Windows Embedded CE logo.

For a different desktop background, you can include a custom background image, such as a graphic that displays the OEM brand image or a graphic that displays the enterprise customer brand image.

Available Graphics Formats

To support desktop backgrounds based on .jpg format, make sure that you have included the JPG Decoder (SYSGEN_IMAGING_JPG_DECODE) in the operating system (OS) design. Otherwise, you must use .bmp format for your desktop background.

Desktop Registry Key

To configure the desktop background on a thin client, edit the HKEY_CURRENT_USER\ControlPanel\Desktop registry key. This registry key is located in wceshellfe.reg at %_WINCEROOT%\PUBLIC\WCESHELLFE\OAK\FILES. The following table shows the named values.

Value Description

wallpaper

Specifies the graphics file that includes the desktop background for a thin client. If .jpg format is used, specify the value directly under the @CESYSGEN IF IMAGING_IMG_JPEGDECODER macro. If .bmp format is used, specify the value directly under the @CESYSGEN ELSE macro.

The default value is \\Windows\\WindowsCE.jpg.

tile

Specifies whether to tile the wallpaper graphics file. Set this value to 1 to display the wallpaper as repeating tiles, or set to 0 to display the wallpaper as usual.

No default value is specified.

To configure the desktop background

  1. In Platform Builder, on the File menu, select Open, and then select File.

  2. In Files of type, select All Files.

  3. Navigate to the %_WINCEROOT%\PUBLIC\WCESHELLFE\OAK\FILES folder.

  4. Select the wceshellfe.reg file and click Open.

  5. In wceshellfe.reg, type directly in the file to edit the HKEY_CURRENT_USER\ControlPanel\Desktop registry key.

  6. On the File menu, select Save wceshellfe.reg.

Note

During the build process, makeimg.exe processes all .reg files in the build directories to create a single file, Reginit.ini. Reginit.ini forms the basis for the system registry.

This registry key is for the local client only and is unrelated to the display of the desktop background during a Terminal Services session.

To decide whether the desktop background on the server is remoted to the thin client during a Terminal Services session, configure the disable wallpaper setting. For more information about this setting for Windows Thin Client Shell, see Configuring the Terminal Services Client. For more information about this setting for Standard Shell, see Terminal Services Client Configuration through the .rdp File.

See Also

Concepts

Configuring the Windows Thin Client Shell