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

  • Статья

Плитки и уведомления могут загружать строки и изображения, адаптированные для языка интерфейса, коэффициента масштабирования дисплея, высокой контрастности и других контекстов среды выполнения. Общие сведения об использовании квалификаторов в именах файлов ресурсов см. в разделах Настройка ресурсов для языка, масштабирования и других квалификаторов и значков приложений и логотипов.

Дополнительные сведения о преимуществах локализации приложений см. в разделе Глобализация и локализация.

Ссылка на строковый ресурс из шаблона

В шаблоне плитки или всплывающего уведомления можно ссылаться на строковый ресурс с помощью схемы URI (универсального кода ресурса) ms-resource, за которой следует идентификатор простого строкового ресурса. Например, если у вас есть файл Resources.resx, который содержит запись ресурса с именем Farewell, значит, у вас есть строковый ресурс с идентификатором Farewell. Дополнительные сведения об использовании идентификаторов строковых ресурсов и файлов ресурсов (.resw) см. в разделе Локализация строк в манифесте пакета приложения и интерфейсе пользователя.

Вот как будет выглядеть ссылка на идентификатор строкового ресурса Farewell в разделе text шаблона с использованием ms-resource.

<text id="1">ms-resource:Farewell</text>

Если схема URI ms-resource не указывается, раздел text будет просто строковым литералом, а не ссылкой на идентификатор.

<text id="1">Farewell</text>

Ссылка на ресурс изображения из шаблона

В шаблоне плитки или всплывающего уведомления можно ссылаться на ресурс изображения с помощью схемы URI (универсального кода ресурса) ms-appx, за которой следует имя ресурса изображения. Это аналогично тому, как используются ссылки на ресурс изображения в разметке XAML (дополнительные сведения см. в разделе Ссылки на изображения и другие ресурсы из кода и разметки XAML).

Например, папки можно назвать следующим образом.

\Assets\Images\contrast-standard\welcome.png
\Assets\Images\contrast-high\welcome.png

В этом случае имеется один ресурс изображения, а его имя (как абсолютный путь) — /Assets/Images/welcome.png. Вот как использовать это имя в шаблоне.

<image id="1" src="ms-appx:///Assets/Images/welcome.png"/>

Обратите внимание, как в этом примере URI за схемой ms-appx следует ://, а далее указан абсолютный путь (начинается с /).

Размещение и загрузка изображений в облаке

Схемы URI ms-resource и ms-appx выполняют автоматическое сопоставление квалификаторов для поиска ресурса, который больше всего подходит текущему контексту. Веб-схемы URI (например, http, https и ftp) не выполняют никакого автоматического сопоставления.

Вместо этого добавьте к URI вашего изображения строку запроса, описывающую запрошенное значение или значения квалификатора.

<image id="1" src="http://www.contoso.com/Assets/Images/welcome.png?ms-lang=en-US"/>

Затем в службе приложения, которая предоставляет изображения, реализуйте обработчик HTTP, который будет проверять и использовать строку запроса, чтобы определить, какое изображение требуется вернуть.

Необходимо также задать атрибуту addImageQuery значение true в полезных данных XML-уведомления плитки или всплывающего уведомления. Атрибут addImageQuery отображается в visualэлементах , bindingи image схем плиток и всплывающих уведомлений. Явно указав addImageQuery для элемента, вы переопределите любое значение, заданное предку этого элемента. Например, значение true для атрибута addImageQuery в элементе image переопределяет значение false для атрибута addImageQuery в родительском элементе binding.

Это строки запросов, которые можно использовать.

Квалификатор Строка запроса Пример
Масштабирование ms-scale ?ms-scale=400
Язык ms-lang ?ms-lang=en-US
Контраст ms-contrast ?ms-contrast=high

Справочную таблицу всех возможных значений квалификаторов, которые можно использовать в строках запросов, см. в разделе ResourceContext.QualifierValues.

Важные API