与小组件选取器集成

在当前版本中，唯一的小组件主机是内置于 Windows 11 的小组件板。 小组件板显示小组件并管理其在开发板上的布局。 它还提供一个小组件选取器，允许用户选择哪些可用小组件在板上可见。 本文介绍小组件成功集成到小组件选取器所需的资产。

小组件屏幕截图图像

当小组件具有焦点时，每个小组件都必须提供一个屏幕截图图像，该图像在小组件选取器中显示为预览。 屏幕截图由应用包清单中的小组件提供程序指定。 有关如何指定要用于小组件屏幕截图的图像文件的技术信息，请参阅 在 win32 应用 和 小组件提供程序包清单 XML 格式中实现小组件提供程序。

以下屏幕截图演示了小组件选取器中屏幕截图图像的位置。

屏幕截图图像要求

为了提供一致的用户体验，小组件选取器的小组件屏幕截图必须遵循以下准则。

• 屏幕截图应显示小组件的中等大小版本。
• 图像宽应为 300 像素，高 304 像素。
• 图像应具有透明圆角。

小组件提供程序清单包括三个不同的 屏幕截图 元素，你可以设置。 顶级屏幕截图是必需的，并将用作小组件选取器的默认屏幕截图。 清单的 LightMode 和 DarkMode 部分是可选的，允许你在浅色和深色模式下为小组件指定单独的屏幕截图。 如果提供这两个可选屏幕截图，小组件选取器将使用与设备当前主题匹配的屏幕截图。 如果未专门提供当前主题的图像，小组件选取器将改用默认的顶级屏幕截图。

可以为多个区域设置提供小组件屏幕截图。 每个屏幕截图的区域设置都指定了相对于应用包的资产的路径。

• 在打包项目中为映像资产创建目录。 例如：“Assets”。
• 语言中性或回退资产可以直接放置在此文件夹中。 例如：“Assets/Screenshot.png”
• 特定于语言的资产可以放置在以应用的区域设置命名的子目录中。 例如：
  • “英语（美国）”资产应放置在名为“en-us”的子目录中：“Assets/en-us/Screenshot.png”
  • “法语（法国）”资产应放置在名为“fr-fr”的子目录中：“Assets/fr-fr/Screenshot.png”
• 使用 ms-appx：URI 方案在 appxmanifest 中引用这些图像。 例如：屏幕截图=“ms-appx：Assets\Screenshot.png”
• 如果未包含特定区域设置的映像，则将使用根目录中的回退映像。

资源加载程序将自动选择要显示的语言适当的资产。 有关详细信息，请参阅： 加载为缩放、主题、高对比度等定制的图像和资产。

下面是小组件屏幕截图图像的示例。