You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: hub/apps/design/widgets/widgets-picker-integration.md
+19-2
Original file line number
Diff line number
Diff line change
@@ -24,11 +24,28 @@ The following screenshot illustrates the placement of the screenshot image withi
24
24
## Screenshot image requirements
25
25
26
26
In order to provide a consistent user experience, widget screenshots for the widget picker must follow the following guidelines.
27
+
27
28
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.
29
30
* The image should be 300 pixels wide and 304 pixels tall.
30
31
* 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
+
32
49
33
50
The following is an example of a widget screenshot image.
0 commit comments