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

  • Artikel

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 sertaikon dan logo Aplikasi lainnya.

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 dengan pengidentifikasi sumber daya string sederhana. Misalnya, jika Anda memiliki file Resources.resx yang berisi entri sumber daya yang namanya "Perpisahan", maka Anda memiliki sumber daya string dengan pengidentifikasi "Perpisahan". 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 literal string, dan bukan referensi ke pengidentifikasi.

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

Merujuk ke sumber daya gambar dari templat

Dalam templat petak peta atau 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 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 oleh "://" yang diikuti oleh jalur absolut (jalur absolut dimulai dengan "/").

Menghosting dan memuat gambar di cloud

ms-resource Skema 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, di 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 , binding, dan image dari skema petak dan toast. Secara eksplisit mengatur addImageQuery pada elemen akan mengambil alih nilai apa pun yang ditetapkan pada leluhur. Misalnya, nilai trueaddImageQuery dalam image elemen mengambil alih addImageQuery dari false dalam elemen induknyabinding.

Ini adalah string kueri yang bisa Anda gunakan.

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

Untuk tabel referensi semua nilai kualifikasi yang mungkin dapat Anda gunakan dalam string kueri Anda, lihat ResourceContext.QualifierValues.

API penting