Skip to content

Commit 89d652a

Browse files
committed
Updates per email thread
1 parent 38c271c commit 89d652a

File tree

1 file changed

+19
-2
lines changed

1 file changed

+19
-2
lines changed

hub/apps/design/widgets/widgets-picker-integration.md

+19-2
Original file line numberDiff line numberDiff line change
@@ -24,11 +24,28 @@ The following screenshot illustrates the placement of the screenshot image withi
2424
## Screenshot image requirements
2525

2626
In order to provide a consistent user experience, widget screenshots for the widget picker must follow the following guidelines.
27+
2728

28-
* The screenshot must show the the light-themed, medium-sized version of your widget.
29+
* The screenshot should contain the medium size version of your widget.
2930
* The image should be 300 pixels wide and 304 pixels tall.
3031
* The image should have transparent, rounded corners.
31-
* If your widget supports right-to-left (RTL) languages, you should provide a separate image for those languages that uses an RTL design.
32+
33+
The widget provider manifest includes three different **Screenshot** elements that you can set. The top-level screenshot is required and will be used as the default by the widget picker. The **LightMode** and **DarkMode** sections of the manifest are optional and allow you to specify separate screenshots for your widget in light and dark modes. If you supply one or both of these optional screenshots, the widget picker will use the one that matches the device's current theme. If you do not supply an image specifically for the current theme, the widget picker will use the default, top-level screenshot instead.
34+
35+
You may provide widget screenshots for multiple locales, including locales that use right-to-left (RTL) languages. The locale for each screenshot is specified with the path to the asset relative to your app package.
36+
37+
* Create a directory in your packaging project for the image assets. For example: "Assets".
38+
* The language-neutral or fallback assets can be placed directly in this folder. For example: "Assets/Logo.png"
39+
* Language-specific assets can be placed in subdirectories named after the locale to which they apply. For example:
40+
* "English (United States)" assets should be placed in a subdirectory named "en-us": "Assets/en-us/Screenshot.png"
41+
* "French (France)" assets should be placed in a subdirectory named "fr-fr": "Assets/fr-fr/Screenshot.png"
42+
* Reference these images in the appxmanifest using the ms-appx: URI scheme. For example: Screenshot="ms-appx:Assets\Screenshot.png"
43+
* If you don’t include an image for a specific locale, then the fallback image in the root directory will be used.
44+
45+
The resource loader will automatically choose the language-appropriate asset to display. For more information, see: [Load images and assets tailored for scale, theme, high contrast, and others](/windows/uwp/app-resources/images-tailored-for-scale-theme-contrast#refer-to-an-image-file-from-your-app-package-manifest).
46+
47+
48+
3249

3350
The following is an example of a widget screenshot image.
3451

0 commit comments

Comments
 (0)