内置于 Windows 11 的小组件面板显示小组件并管理其布局。 其小组件选取器允许用户选择要添加到面板的可用小组件。 本文介绍将打包的桌面小组件提供程序集成到该选取器所需的资源。 有关 PWA 的清单字段,请参阅 构建 PWA 驱动的小组件。
小组件屏幕截图图像
当小组件具有焦点时,每个小组件都必须提供一个屏幕截图图像,该图像在小组件选取器中显示为预览。 屏幕截图由应用包清单中的小组件提供程序指定。 有关如何指定要用于小组件屏幕截图的图像文件的技术信息,请参阅 在 win32 应用 和 小组件提供程序包清单 XML 格式中实现小组件提供程序。
以下屏幕截图演示了小组件选取器中屏幕截图图像的位置。
屏幕截图图像要求
为了提供一致的用户体验,小组件选取器的小组件屏幕截图必须遵循这些准则。
- 屏幕截图应显示小组件的中等大小版本。
- 图像宽应为 300 像素,高 304 像素。
- 图像应具有透明圆角。
小组件提供程序清单包括三个不同的 屏幕截图 元素,你可以设置。 必需顶级屏幕截图,小组件选取器将默认使用此截图。 清单文件的 LightMode 和 DarkMode 部分是可选的,允许你在浅色和深色模式下为组件指定单独的屏幕截图。 如果提供这两个可选屏幕截图,小组件选取器将使用与设备当前主题匹配的屏幕截图。 如果未专门提供当前主题的图像,小组件选取器将改用默认的顶级屏幕截图。
你可以为多个区域设置提供小组件屏幕截图。 每个屏幕截图的区域设置通过相对于应用包的资产生径指定。
- 在打包项目中为映像资产创建目录。 例如:“资产”。
- 语言中性或备用资源可以直接放在此文件夹中。 例如:“Assets/Screenshot.png”
- 特定语言的资源可以放置在根据对应区域设置命名的子目录中。 例如:
- “英语(美国)”资产应放置在名为“en-us”的子目录中:“Assets/en-us/Screenshot.png”
- “法语(法国)”资产应放置在名为“fr-fr”的子目录中:“Assets/fr-fr/Screenshot.png”
- 使用 ThemeResources/Screenshots 下 Screenshot 元素的包相对 Path 属性引用回退资源。 例如:
<Screenshot Path="Assets\Screenshot.png" DisplayAltText="Preview of the widget" />。 请勿在此清单元素中使用Screenshot属性或ms-appx:URI。 - 如果未包含特定区域设置的映像,则将使用根目录中的回退映像。
资源加载程序将自动选择要显示的适合语言的资源。 有关详细信息,请参阅: 加载为缩放、主题、高对比度等定制的图像和资产。
以下是小组件屏幕截图图像的示例。