DesktopBackground

DesktopBackground 指定用于桌面背景的图形文件的路径。 桌面背景图像可以位于 %windir% 下的任何子文件夹中。 只能在默认主题中设置桌面背景。

图像将裁剪以适应显示器大小，同时保留图像的纵横比。

选择一个在裁剪为计算机常用纵横比后看起来不错的图像。 在大多数情况下，建议使用 1920x1200 的图像，图像的焦点靠近中心。

图形可以有任何名称，但必须是 .png、.jpg 或 .bmp 格式的图像。

注意

在 Windows 10 中，如果使用此设置，还需要设置 ThemeName。 如果对这两个设置（ThemeName 和 DesktopBackground）进行设置，Windows 将为你创建主题。

值

Path_to_background_image_file

指定图形文件的路径。 Path_to_background_image_file 是一个字符串，最大长度为 259 个字符。

该字符串类型支持空元素。

有效配置阶段

specialize

auditSystem

auditUser

oobeSystem

父层次结构

Microsoft-Windows-Shell-Setup | Themes | DesktopBackground

应用于

有关此组件支持的 Windows 版本和体系结构的列表，请参阅 Microsoft-Windows-Shell-Setup。

XML 示例

下面的 XML 输出显示如何为自定义主题分配背景。

<settings pass="oobeSystem">
    <component processorArchitecture="x86" publicKeyToken="31bf3856ad364e35" versionScope="nonSxS" name="Microsoft-Windows-Shell-Setup" language="neutral">
        <Themes>
            <ThemeName>Fabrikam Theme</ThemeName>
            <DesktopBackground>%WINDIR%\web\wallpaper\fabrikam.jpg</DesktopBackground>
        </Themes>
    </component>
</settings>

相关主题

Themes