pengikatan (Skema petak peta)

Artikel
07/20/2023

Menentukan templat petak peta. Setiap pemberitahuan harus menyertakan satu elemen pengikatan untuk setiap ukuran petak peta yang didukung.

Hierarki elemen

<Ubin>

<Visual>: <pengikatan>

Sintaks

<binding template       = tileTemplateNameV2
         fallback?      = tileTemplateNameV1
         lang?          = string
         baseUri?       = anyURI
         branding?      = "none" | "logo" | "name"
         addImageQuery? = boolean
         contentId?     = string >

  <!-- Child elements -->
  ( image
  | text
  )*

</binding>

Kunci

? opsional (nol atau satu) * opsional (nol atau lebih)

Atribut dan Elemen

Atribut

Atribut	Deskripsi	Jenis Data	Diperlukan	Nilai default
addImageQuery	Atur ke true untuk memungkinkan Windows menambahkan string kueri ke URI gambar yang disediakan dalam pemberitahuan petak peta. Gunakan atribut ini jika server Anda menghosting gambar dan dapat menangani string kueri, baik dengan mengambil varian gambar berdasarkan string kueri atau dengan mengabaikan string kueri dan mengembalikan gambar seperti yang ditentukan tanpa string kueri. String kueri ini menentukan skala, pengaturan kontras, dan bahasa; misalnya, nilai "www.website.com/images/hello.png" disertakan dalam pemberitahuan menjadi "www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us"	boolean	Tidak	salah
baseUri	URI dasar default yang dikombinasikan dengan URI relatif dalam atribut sumber gambar.	anyURI	Tidak	ms-appx:///
Branding	Formulir yang harus digunakan petak peta untuk menampilkan merek aplikasi.	Atribut ini dapat memiliki salah satu nilai berikut: tidak ada logo nama	Tidak	logo
contentId	Atur ke string yang ditentukan pengirim yang secara unik mengidentifikasi konten pemberitahuan. Ini mencegah duplikat dalam situasi di mana templat petak peta besar menampilkan tiga pemberitahuan petak peta lebar terakhir.	string	Tidak
Fallback	Templat yang digunakan jika nama templat utama tidak dikenali oleh penerima, untuk digunakan dengan kompatibilitas Windows 8. Nilai ini adalah nama Windows 8 nilai dalam atribut templat. Templat baru yang diperkenalkan setelah Windows 8 tidak memiliki fallback.	tileTemplateNameV1 (lihat Keterangan)	Tidak	Tidak ada
Lang	Lokal target payload XML, ditentukan sebagai tag bahasa BCP-47 seperti "en-US" atau "fr-FR". Lokal yang ditentukan di sini mengambil alihnya dalam visual, tetapi dapat ditimpa olehnya dalam teks. Jika nilai ini adalah string harfiah, atribut ini default ke bahasa UI pengguna. Jika nilai ini adalah referensi string, atribut ini default ke lokal yang dipilih oleh Windows Runtime dalam menyelesaikan string. Lihat Keterangan saat nilai ini tidak ditentukan.	string	Tidak	Tidak ada
templat	Salah satu templat yang disediakan untuk mendasarkan petak peta. Biasanya, pengembang harus menyediakan format persegi dan lebar, masing-masing sebagai elemen pengikatan terpisah. Entri yang valid adalah anggota enumerasi tileTemplateType .	tileTemplateNameV2 (lihat Keterangan)	Ya	Tidak ada

Elemen Anak

Elemen Anak	Deskripsi
gambar	Menentukan gambar yang digunakan dalam templat petak peta. Gambar yang disediakan harus sesuai dengan persyaratan ukuran dan bentuk untuk templat atau gambar tertentu dalam templat tersebut.
teks	Menentukan teks yang digunakan dalam templat petak peta.

Elemen Induk

Elemen Induk	Deskripsi
Visual	Berisi beberapa elemen anak yang mengikat , yang masing-masing mendefinisikan petak peta.

Keterangan

Nilai tileTemplateNameV2 yang digunakan dalam atribut templat bisa menjadi salah satu nilai string berikut. Untuk detail tentang setiap templat, lihat Katalog templat petak peta.

Petak PetaSquare150x150Block
Petak PetaSquare150x150Image
Petak PetaSquare150x150PeekImageAndText01
Petak PetaSquare150x150PeekImageAndText02
Petak PetaSquare150x150PeekImageAndText03
Petak PetaSquare150x150PeekImageAndText04
Petak PetaSquare150x150Text01
Petak PetaSquare150x150Text02
Petak PetaSquare150x150Text03
Petak PetaSquare150x150Text04
Petak PetaSquare310x310BlockAndText01
Petak PetaSquare310x310BlockAndText02
TileSquare310x310Image
Petak PetaSquare310x310ImageAndText01
Petak PetaSquare310x310ImageAndText02
Petak PetaSquare310x310ImageAndTextOverlay01
Petak PetaSquare310x310ImageAndTextOverlay02
Petak PetaSquare310x310ImageAndTextOverlay03
TileSquare310x310ImageCollection
Petak PetaSquare310x310ImageCollectionAndText01
Petak PetaSquare310x310ImageCollectionAndText02
Petak PetaSquare310x310SmallImagesAndTextList01
Petak PetaSquare310x310SmallImagesAndTextList02
Petak PetaSquare310x310SmallImagesAndTextList03
Petak PetaSquare310x310SmallImagesAndTextList04
Petak PetaSquare310x310Text01
Petak PetaSquare310x310Text02
Petak PetaSquare310x310Text03
Petak PetaSquare310x310Text04
Petak PetaSquare310x310Text05
Petak PetaSquare310x310Text06
Petak PetaSquare310x310Text07
Petak PetaSquare310x310Text08
Petak PetaSquare310x310TextList01
Petak PetaSquare310x310TextList02
Petak PetaSquare310x310TextList03
Petak PetaWide310x150BlockAndText01
TileWide310x150BlockAndText02
TileWide310x150Image
TileWide310x150ImageAndText01
TileWide310x150ImageAndText02
TileWide310x150ImageCollection
TileWide310x150PeekImage01
TileWide310x150PeekImage02
TileWide310x150PeekImage03
TileWide310x150PeekImage04
TileWide310x150PeekImage05
TileWide310x150PeekImage06
TileWide310x150PeekImageAndText01
TileWide310x150PeekImageAndText02
TileWide310x150PeekImageCollection01
TileWide310x150PeekImageCollection02
TileWide310x150PeekImageCollection03
TileWide310x150PeekImageCollection04
TileWide310x150PeekImageCollection05
TileWide310x150PeekImageCollection06
TileWide310x150SmallImageAndText01
TileWide310x150SmallImageAndText02
TileWide310x150SmallImageAndText03
TileWide310x150SmallImageAndText04
TileWide310x150SmallImageAndText05
TileWide310x150Text01
TileWide310x150Text02
TileWide310x150Text03
TileWide310x150Text04
TileWide310x150Text05
TileWide310x150Text06
Petak PetaWide310x150Text07
TileWide310x150Text08
TileWide310x150Text09
TileWide310x150Text10
Petak PetaWide310x150Text11

Nilai tileTemplateNameV1 yang digunakan dalam atribut fallback dapat menjadi salah satu nilai string berikut. Ini adalah nama templat Windows 8. Untuk detail tentang setiap templat, lihat Katalog templat petak peta.

TileSquareBlock
TileSquareImage
TileSquarePeekImageAndText01
TileSquarePeekImageAndText02
TileSquarePeekImageAndText03
TileSquarePeekImageAndText04
TileSquareText01
TileSquareText02
TileSquareText03
TileSquareText04
TileWideBlockAndText01
TileWideBlockAndText02
TileWideImage
TileWideImageAndText01
TileWideImageAndText02
TileWideImageCollection
TileWidePeekImage01
TileWidePeekImage02
TileWidePeekImage03
TileWidePeekImage04
TileWidePeekImage05
TileWidePeekImage06
TileWidePeekImageAndText01
TileWidePeekImageAndText02
TileWidePeekImageCollection01
TileWidePeekImageCollection02
TileWidePeekImageCollection03
TileWidePeekImageCollection04
TileWidePeekImageCollection05
TileWidePeekImageCollection06
TileWideSmallImageAndText01
TileWideSmallImageAndText02
TileWideSmallImageAndText03
TileWideSmallImageAndText04
TileWideSmallImageAndText05
TileWideText01
TileWideText02
TileWideText03
TileWideText04
TileWideText05
TileWideText06
TileWideText07
TileWideText08
TileWideText09
TileWideText10
TileWideText11

Tabel berikut menjelaskan bagaimana sistem merespons ketika bahasa tidak ditentukan.

Untuk...	Respons sistem
Bahasa untuk pemberitahuan	Jika diatur secara eksplisit, gunakan visual.lang atau binding.lang Jika tidak, pengaturan bahasa khusus aplikasi (bahasa, jika ada, bahwa [Sistem Manajemen Sumber Daya](/previous-versions/windows/apps/jj552947(v=win.10)) menentukan aplikasi akan berjalan dalam profil bahasa saat ini) Bahasa lain dari nama tampilan pada petak peta seperti yang diselesaikan oleh Windows Runtime Lain bahasa UI Shell (bahasa MUI) Bahasa ini terutama memengaruhi tata letak kolom dalam templat yang menampilkan kolom.
Elemen teks dengan teks harfiah	Jika diatur secara eksplisit, gunakan visual.lang atau binding.lang Jika tidak, pengaturan bahasa khusus aplikasi (bahasa, jika ada, bahwa [Sistem Manajemen Sumber Daya](/previous-versions/windows/apps/jj552947(v=win.10)) menentukan aplikasi akan berjalan dalam profil bahasa saat ini) Bahasa lain dari nama tampilan pada petak peta seperti yang diselesaikan oleh Windows Runtime Lain bahasa UI shell (bahasa MUI)
Elemen teks dengan konten ms-resource	Jika diatur secara eksplisit, gunakan visual.lang atau binding.lang, dan bahasa eksplisit ditambahkan ke daftar bahasa [ResourceContext](/previous-versions/windows/apps/jj552947(v=win.10)#resourcecontext) yang digunakan untuk mengatasi string Jika tidak, [ResourceContext](/previous-versions/windows/apps/jj552947(v=win.10)#resourcecontext) digunakan sebagai diinisialisasi dengan profil bahasa pengguna Setelah string diselesaikan, bahasa untuk string yang diselesaikan ditetapkan ke elemen teks. Bahasa ini membentuk perataan teks (LTR vs. RTL) dan pilihan font untuk UI.
gambar ms-appx:///	Jika diatur secara eksplisit, gunakan visual.lang atau binding.lang, bahasa eksplisit ditambahkan ke daftar bahasa [ResourceContext](/previous-versions/windows/apps/jj552947(v=win.10)#resourcecontext) yang digunakan untuk mengatasi string Jika tidak, [ResourceContext](/previous-versions/windows/apps/jj552947(v=win.10)#resourcecontext) yang kami gunakan sebagai diinisialisasi dengan profil bahasa pengguna
Gambar cloud	Jika diatur secara eksplisit, gunakan visual.lang atau binding.lang Selain pengaturan bahasa khusus aplikasi (bahasa, jika ada, bahwa [Sistem Manajemen Sumber Daya](/previous-versions/windows/apps/jj552947(v=win.10)) menentukan aplikasi akan berjalan dalam profil bahasa saat ini) Bahasa lain dari nama tampilan pada petak peta seperti yang diselesaikan oleh Windows Runtime (mungkin tidak diatur jika namanya netral bahasa) Lain bahasa UI Shell (bahasa MUI) Bahasa ini disertakan dalam string kueri jika addImageQuery benar.

Persyaratan

	Nilai
Ruang nama	`http://schemas.microsoft.com/notifications/2012/tile.xsd`