DesktopBackground (Standard 8 Module Reference)

7/8/2014

Review the applicable Embedded Core modules and any examples for the DesktopBackground setting in Windows Embedded 8 Standard (Standard 8).

This setting contains a string with a maximum length of 259 characters that specifies the path to a .jpg or .bmp graphic file that is used for the screen background. This setting can be empty.

The image will be cropped to fit the size of your display, while preserving the aspect ratio of the image.

Select an image that will look good when cropped to the common aspect ratios for your device. In most cases, we recommend a 1920x1200 image with a focal point near the center.

Modules

The following table shows the modules that you can apply this setting to. In Image Configuration Editor (ICE), you can follow the corresponding path to set this setting for a module.

Module

Path

Shell-Setup

Products/Embedded Core/Shell-Setup/Themes/DesktopBackground

XML Example

The following XML example shows how to assign a background to a customized theme.

<Themes>
      <ThemeName>Fabrikam Theme</ThemeName>
      <DesktopBackground>%WINDIR%\web\wallpaper\fabrikam.jpg</DesktopBackground>
</Themes>

See Also

Concepts

Embedded Core Settings