Bagikan melalui


Dukungan pemberitahuan petak peta dan toast untuk bahasa, skala, dan kontras tinggi

Petak peta dan roti panggang Anda dapat memuat string dan gambar yang disesuaikan untuk bahasa tampilan, faktor skala tampilan, kontras tinggi, dan konteks runtime lainnya. Untuk latar belakang tentang cara menggunakan kualifikasi dalam nama file sumber daya Anda, lihat Menyesuaikan sumber daya Anda untuk bahasa, skala, dan kualifikasi lainnya serta ikon dan logo Aplikasi.

Untuk informasi selengkapnya tentang proposisi nilai pelokalan aplikasi Anda, lihat Globalisasi dan pelokalan.

Merujuk ke sumber daya string dari templat

Dalam templat petak peta atau roti panggang, Anda dapat merujuk ke sumber daya string menggunakan ms-resource skema URI (Pengidentifikasi Sumber Daya Seragam) diikuti oleh pengidentifikasi sumber daya string sederhana. Misalnya, jika Anda memiliki file Resources.resx yang berisi entri sumber daya yang namanya "Farewell", maka Anda memiliki sumber daya string dengan pengidentifikasi "Farewell". Untuk informasi selengkapnya tentang pengidentifikasi sumber daya string dan File Sumber Daya (.resw), lihat Melokalkan string di manifes UI dan paket aplikasi Anda.

Ini adalah bagaimana referensi ke pengidentifikasi sumber daya string "Perpisahan" akan terlihat di isi teks konten templat Anda, menggunakan ms-resource.

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

Jika Anda menghilangkan ms-resource skema URI, isi teks hanyalah string literal, dan bukan referensi ke pengidentifikasi.

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

Merujuk ke sumber daya gambar dari templat

Dalam petak peta atau templat roti panggang, Anda dapat merujuk ke sumber daya gambar menggunakan ms-appx skema URI (Pengidentifikasi Sumber Daya Seragam) diikuti dengan nama sumber daya gambar. Ini adalah cara yang sama seperti Anda merujuk ke sumber daya gambar di markup XAML (untuk detail selengkapnya, lihat Mereferensikan gambar atau aset lain dari markup dan kode XAML).

Misalnya, Anda mungkin memberi nama folder seperti ini.

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

Dalam hal ini, Anda memiliki satu sumber daya gambar dan namanya (sebagai jalur absolut) adalah /Assets/Images/welcome.png. Berikut adalah cara Anda menggunakan nama tersebut di templat Anda.

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

Perhatikan bagaimana dalam contoh ini URI skema ("ms-appx") diikuti dengan "://" yang diikuti oleh jalur absolut (jalur absolut dimulai dengan "/").

Menghosting dan memuat gambar di cloud

Skema ms-resource URI dan ms-appx melakukan pencocokan kualifikasi otomatis untuk menemukan sumber daya yang paling sesuai untuk konteks saat ini. Skema URI web (misalnya, , http, httpsdan ftp) tidak melakukan pencocokan otomatis tersebut.

Sebagai gantinya, tambahkan ke URI gambar Anda string kueri yang menjelaskan nilai atau nilai kualifikasi yang diminta.

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

Kemudian, dalam layanan aplikasi yang menyediakan gambar Anda, terapkan handler HTTP yang memeriksa dan menggunakan string kueri untuk menentukan gambar mana yang akan dikembalikan.

Anda juga perlu mengatur atribut addImageQuery ke true dalam payload XML pemberitahuan petak atau toast. Atribut addImageQuery muncul di visualelemen , , bindingdan image dari skema petak peta dan toast. Mengatur addImageQuery secara eksplisit pada elemen menggantikan nilai apa pun yang ditetapkan pada leluhur. Misalnya, nilai true addImageQuery dalam image elemen mengambil alih addImageQuery dari false dalam elemen induknyabinding.

Ini adalah string kueri yang bisa Anda gunakan.

Pengualifikasi Untai kueri Contoh
Sisik skala ms ?ms-scale=400
Bahasa ms-lang ?ms-lang=en-US
Kontras ms-contrast ?ms-contrast=high

Untuk tabel referensi dari semua kemungkinan nilai kualifikasi yang bisa Anda gunakan dalam string kueri Anda, lihat ResourceContext.QualifierValues.

API penting