Export (0) Print
Expand All

DesktopBackground

Updated: August 1, 2012

Applies To: Windows 7, Windows 8, Windows 8.1, Windows Server 2008 R2, Windows Server 2012, Windows Server 2012 R2

DesktopBackground specifies the path to a graphic file that is used for the desktop background.

The image will be cropped to fit the size of your display, while preserving the aspect ratio of the image. This corresponds to the option: Picture Position: Fill in the Desktop Background page in the Control Panel.

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

The graphic must be a .jpg or .bmp image.

 

Path_to_background_image_file

Specifies the path to the graphic file. Path_to_background_image_file is a string with a maximum length of 259 characters.

This string type supports empty elements.

specialize

auditSystem

auditUser

oobeSystem

For a list of the Windows® editions and architectures that this component supports, see Microsoft-Windows-Shell-Setup.

The following XML output 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

Themes

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft