与小组件选取器集成

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

小组件屏幕截图图像

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

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

屏幕截图图像要求

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

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

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

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

• 在打包项目中为映像资产创建目录。 例如：“资产”。
• 可以直接将非特定语言资产或回退资产放在此文件夹中。 例如：“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”
• 如果未包含特定区域设置的映像，则将使用根目录中的回退映像。

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

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