Интеграция с выборщиком виджетов

В текущем выпуске единственным узлом виджетов является Панель виджетов, встроенная в 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"
• Укажите эти изображения в appxmanifest с использованием схемы URI ms-appx. Например: снимок экрана="ms-appx:Assets\Screenshot.png"
• Если вы не предоставляете изображение для конкретного языкового стандарта, то будет использоваться резервное изображение из корневого каталога.

Загрузчик ресурсов автоматически выбирает соответствующий языку ресурс для отображения. Дополнительные сведения см. в статье о загрузке изображений и ресурсов, адаптированных для масштабирования, темы, высокой контрастности и других.

Ниже приведен пример изображения снимка экрана мини-приложения.