Share via

Skema konten petak peta

  • Artikel

Berikut ini menjelaskan semua properti dan elemen dalam konten petak peta.

Jika Anda lebih suka menggunakan XML mentah alih-alih pustaka Pemberitahuan, silakan lihat skema XML.

TileContent

TileContent

TileContent adalah objek tingkat atas yang menjelaskan konten pemberitahuan petak peta, termasuk visual.

Properti Jenis Wajib Deskripsi
Visual ToastVisual benar Menjelaskan bagian visual pemberitahuan petak peta.

Petak PetaVisual

Bagian visual petak peta berisi spesifikasi visual untuk semua ukuran petak peta, dan properti yang lebih terkait visual.

Properti Jenis Wajib Deskripsi
TileSmall TileBinding salah Berikan pengikatan kecil opsional untuk menentukan konten untuk ukuran petak peta kecil.
TileMedium TileBinding salah Berikan pengikatan sedang opsional untuk menentukan konten untuk ukuran petak peta sedang.
TileWide TileBinding salah Berikan pengikatan lebar opsional untuk menentukan konten untuk ukuran petak peta lebar.
TileLarge TileBinding salah Berikan pengikatan besar opsional untuk menentukan konten untuk ukuran petak peta besar.
Pencitrraan merek TileBranding salah Formulir yang harus digunakan petak peta untuk menampilkan merek aplikasi. Secara default, mewarisi branding dari petak peta default.
DisplayName string salah String opsional untuk mengambil alih nama tampilan petak peta sambil menampilkan pemberitahuan ini.
Argumen string salah Baru di Pembaruan Hari Jadi: Data yang ditentukan aplikasi yang diteruskan kembali ke aplikasi Anda melalui properti TileActivatedInfo di LaunchActivatedEventArgs saat pengguna meluncurkan aplikasi Anda dari Petak Peta Langsung. Ini memungkinkan Anda untuk mengetahui pemberitahuan petak peta mana yang dilihat pengguna Anda saat mereka mengetuk Petak Peta Langsung Anda. Pada perangkat tanpa Pembaruan Hari Jadi, ini hanya akan diabaikan.
LockDetailedStatus1 string salah Jika Anda menentukan ini, Anda juga harus menyediakan pengikatan TileWide. Ini adalah baris pertama teks yang akan ditampilkan di layar kunci jika pengguna telah memilih petak peta Anda sebagai aplikasi status terperinci mereka.
LockDetailedStatus2 string salah Jika Anda menentukan ini, Anda juga harus menyediakan pengikatan TileWide. Ini adalah baris kedua teks yang akan ditampilkan di layar kunci jika pengguna telah memilih petak peta Anda sebagai aplikasi status terperinci mereka.
LockDetailedStatus3 string salah Jika Anda menentukan ini, Anda juga harus menyediakan pengikatan TileWide. Ini adalah baris ketiga teks yang akan ditampilkan di layar kunci jika pengguna telah memilih petak peta Anda sebagai aplikasi status terperinci mereka.
BaseUri Uri salah URL dasar default yang dikombinasikan dengan URL relatif dalam atribut sumber gambar.
AddImageQuery Bool? salah Atur ke "true" untuk memungkinkan Windows menambahkan string kueri ke URL gambar yang disediakan dalam pemberitahuan toast. 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" yang diberikan dalam pemberitahuan menjadi "www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us"
Bahasa string salah Lokal target payload visual saat menggunakan sumber daya yang dilokalkan, ditentukan sebagai tag bahasa BCP-47 seperti "en-US" atau "fr-FR". Lokal ini ditimpa oleh lokal apa pun yang ditentukan dalam pengikatan atau teks. Jika tidak disediakan, lokal sistem akan digunakan sebagai gantinya.

TileBinding

Objek pengikatan berisi konten visual untuk ukuran petak peta tertentu.

Properti Jenis Wajib Deskripsi
Konten ITileBindingContent salah Konten visual yang akan ditampilkan pada petak peta. Salah satu TileBindingContentAdaptive, TileBindingContentIconic, TileBindingContentContact, TileBindingContent Orang, atau TileBindingContentPhotos.
Pencitrraan merek TileBranding salah Formulir yang harus digunakan petak peta untuk menampilkan merek aplikasi. Secara default, mewarisi branding dari petak peta default.
DisplayName string salah String opsional untuk mengambil alih nama tampilan petak peta untuk ukuran petak peta ini.
Argumen string salah Baru di Pembaruan Hari Jadi: Data yang ditentukan aplikasi yang diteruskan kembali ke aplikasi Anda melalui properti TileActivatedInfo di LaunchActivatedEventArgs saat pengguna meluncurkan aplikasi Anda dari Petak Peta Langsung. Ini memungkinkan Anda untuk mengetahui pemberitahuan petak peta mana yang dilihat pengguna Anda saat mereka mengetuk Petak Peta Langsung Anda. Pada perangkat tanpa Pembaruan Hari Jadi, ini hanya akan diabaikan.
BaseUri Uri salah URL dasar default yang dikombinasikan dengan URL relatif dalam atribut sumber gambar.
AddImageQuery Bool? salah Atur ke "true" untuk memungkinkan Windows menambahkan string kueri ke URL gambar yang disediakan dalam pemberitahuan toast. 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" yang diberikan dalam pemberitahuan menjadi "www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us"
Bahasa string salah Lokal target payload visual saat menggunakan sumber daya yang dilokalkan, ditentukan sebagai tag bahasa BCP-47 seperti "en-US" atau "fr-FR". Lokal ini ditimpa oleh lokal apa pun yang ditentukan dalam pengikatan atau teks. Jika tidak disediakan, lokal sistem akan digunakan sebagai gantinya.

ITileBindingContent

Antarmuka penanda untuk konten pengikatan petak peta. Ini memungkinkan Anda memilih apa yang ingin Anda tentukan visual petak peta Anda - Adaptif, atau salah satu templat khusus.

Implementasi
TileBindingContentAdaptive
TileBindingContentIconic
TileBindingContentContact
TileBindingContent Orang
TileBindingContentPhotos

TileBindingContentAdaptive

Didukung pada semua ukuran. Ini adalah cara yang direkomendasikan untuk menentukan konten petak peta Anda. Templat Petak Peta Adaptif baru di Windows 10, dan Anda dapat membuat berbagai petak peta kustom melalui adaptif.

Properti Jenis Wajib Deskripsi
Anak IList<ITileBindingContentAdaptiveChild> salah Elemen visual sebaris. Objek AdaptiveText, AdaptiveImage, dan AdaptiveGroup dapat ditambahkan. Anak-anak ditampilkan dengan cara StackPanel vertikal.
BackgroundImage TileBackgroundImage salah Gambar latar belakang opsional yang ditampilkan di belakang semua konten Petak Peta, berdarah penuh.
PeekImage TilePeekImage salah Gambar intip opsional yang menganimasikan dari bagian atas Petak.
Tumpukan Teks TileTextStacking salah Mengontrol tumpukan teks (perataan vertikal) konten anak secara keseluruhan.

AdaptiveText

Elemen teks adaptif.

Properti Jenis Wajib Deskripsi
Teks string salah Teks yang akan ditampilkan.
HintStyle AdaptiveTextStyle salah Gaya mengontrol ukuran font, berat, dan keburaman teks.
HintWrap Bool? salah Atur ini ke true untuk mengaktifkan pembungkusan teks. Default ke false.
HintMaxLines Int? salah Jumlah maksimum baris yang diizinkan untuk ditampilkan oleh elemen teks.
HintMinLines Int? salah Jumlah minimum baris yang harus ditampilkan elemen teks.
HintAlign AdaptiveTextAlign salah Perataan horizontal teks.
Bahasa string salah Lokal target payload XML, ditentukan sebagai tag bahasa BCP-47 seperti "en-US" atau "fr-FR". Lokal yang ditentukan di sini mengambil alih lokal lain yang ditentukan, seperti dalam pengikatan atau visual. Jika nilai ini adalah string literal, 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.

AdaptiveTextStyle

Gaya teks mengontrol ukuran font, berat, dan opasitas. Keburaman lembut adalah 60% buram.

Value Makna
Default Nilai default. Gaya ditentukan oleh perender.
Caption Lebih kecil dari ukuran font paragraf.
CaptionSubtle Sama seperti Keterangan tetapi dengan keburaman yang halus.
Isi Ukuran font paragraf.
BodySubtle Sama seperti Tubuh tetapi dengan keburaman.
Dasar Ukuran font paragraf, bobot tebal. Pada dasarnya versi Bodi yang tebal.
BaseSubtle Sama seperti Base tetapi dengan keburaman yang halang.
Subjudul Ukuran font H4.
SubtitleSubtle Sama seperti Subtitel tetapi dengan keburaman yang halang.
Judul Ukuran font H3.
TitleSubtle Sama seperti Judul tetapi dengan keburaman yang halang.
TitleNumeral Sama seperti Judul tetapi dengan padding atas/bawah dihapus.
Subheader Ukuran font H2.
SubheaderSubtle Sama seperti Subheader tetapi dengan keburaman.
SubheaderNumeral Sama seperti Subheader tetapi dengan padding atas/bawah dihapus.
Header Ukuran font H1.
HeaderSubtle Sama seperti Header tetapi dengan keburaman yang halang.
HeaderNumeral Sama seperti Header tetapi dengan padding atas/bawah dihapus.

AdaptiveTextAlign

Mengontrol perataan horizontal teks.

Value Makna
Default Nilai default. Perataan secara otomatis ditentukan oleh perender.
Auto Perataan ditentukan oleh bahasa dan budaya saat ini.
Left Ratakan teks secara horizontal ke kiri.
Pusat Ratakan teks secara horizontal di tengah.
Kanan Ratakan teks secara horizontal ke kanan.

AdaptiveImage

Gambar sebaris.

Properti Jenis Wajib Deskripsi
Sumber string benar URL ke gambar. ms-appx, ms-appdata, dan http didukung. Pada Pembaruan Fall Creators, gambar web dapat mencapai 3 MB pada koneksi normal dan 1 MB pada koneksi terukur. Pada perangkat yang belum menjalankan Pembaruan Fall Creators, gambar web tidak boleh lebih besar dari 200 KB.
HintCrop AdaptiveImageCrop salah Mengontrol pemotongan gambar yang diinginkan.
HintRemoveMargin Bool? salah Secara default, gambar di dalam grup/subgrup memiliki margin 8px di sekitarnya. Anda dapat menghapus margin ini dengan mengatur properti ini ke true.
HintAlign AdaptiveImageAlign salah Perataan horizontal gambar.
Teks Alternatif string salah Teks alternatif yang menjelaskan gambar, digunakan untuk tujuan aksesibilitas.
AddImageQuery Bool? salah Atur ke "true" untuk memungkinkan Windows menambahkan string kueri ke URL 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" yang diberikan dalam pemberitahuan menjadi "www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us"

AdaptiveImageCrop

Menentukan pemotongan gambar yang diinginkan.

Value Makna
Default Nilai default. Perilaku pemotongan ditentukan oleh perender.
Tidak Gambar tidak dipangkas.
Lingkaran Gambar dipangkas ke bentuk lingkaran.

AdaptiveImageAlign

Menentukan perataan horizontal untuk gambar.

Value Makna
Default Nilai default. Perilaku perataan ditentukan oleh perender.
Stretch Gambar membentang untuk mengisi lebar yang tersedia (dan tinggi yang berpotensi tersedia juga, tergantung di mana gambar ditempatkan).
Left Sejajarkan gambar ke kiri, menampilkan gambar pada resolusi aslinya.
Pusat Sejajarkan gambar di tengah secara horizontal, tampilkan gambar pada resolusi aslinya.
Kanan Sejajarkan gambar ke kanan, menampilkan gambar pada resolusi aslinya.

AdaptiveGroup

Grup secara semantik mengidentifikasi bahwa konten dalam grup harus ditampilkan secara keseluruhan, atau tidak ditampilkan jika tidak cocok. Grup juga memungkinkan pembuatan beberapa kolom.

Properti Jenis Wajib Deskripsi
Anak IList<AdaptiveSubgroup> salah Subgrup ditampilkan sebagai kolom vertikal. Anda harus menggunakan subgrup untuk menyediakan konten apa pun di dalam AdaptiveGroup.

AdaptiveSubgroup

Subgrup adalah kolom vertikal yang dapat berisi teks dan gambar.

Properti Jenis Wajib Deskripsi
Anak IList<IAdaptiveSubgroupChild> salah AdaptiveText dan AdaptiveImage adalah turunan subgrup yang valid.
HintWeight Int? salah Kontrol lebar kolom subgrup ini dengan menentukan bobot, relatif terhadap subgrup lainnya.
HintTextStacking AdaptiveSubgroupTextStacking salah Kontrol perataan vertikal isi subgrup ini.

IAdaptiveSubgroupChild

Antarmuka penanda untuk anak subgrup.

Implementasi
AdaptiveText
AdaptiveImage

AdaptiveSubgroupTextStacking

TextStacking menentukan perataan vertikal konten.

Value Makna
Default Nilai default. Perender secara otomatis memilih perataan vertikal default.
Atas Rata vertikal ke bagian atas.
Pusat Rata vertikal ke tengah.
Bawah Rata vertikal ke bagian bawah.

TileBackgroundImage

Gambar latar belakang ditampilkan berdarah penuh pada petak peta.

Properti Jenis Wajib Deskripsi
Sumber string benar URL ke gambar. ms-appx, ms-appdata, dan http didukung. Gambar http harus berukuran 200 KB atau kurang.
HintOverlay Int? salah Overlay hitam pada gambar latar belakang. Nilai ini mengontrol keburaman overlay hitam, dengan 0 tidak ada overlay dan 100 menjadi benar-benar hitam. Default ke 20.
HintCrop TileBackgroundImageCrop salah Baru di 1511: Tentukan bagaimana Anda ingin gambar dipotong. Dalam versi sebelum 1511, ini akan diabaikan dan gambar latar belakang akan ditampilkan tanpa pemotongan apa pun.
Teks Alternatif string salah Teks alternatif yang menjelaskan gambar, digunakan untuk tujuan aksesibilitas.
AddImageQuery Bool? salah Atur ke "true" untuk memungkinkan Windows menambahkan string kueri ke URL 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" yang diberikan dalam pemberitahuan menjadi "www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us"

TileBackgroundImageCrop

Mengontrol pemotongan gambar latar belakang.

Value Makna
Default Pemotongan menggunakan perilaku default perender.
Tidak Gambar tidak dipotong, ditampilkan persegi.
Lingkaran Gambar dipangkas ke lingkaran.

TilePeekImage

Gambar intip yang menganimasikan dari bagian atas petak peta.

Properti Jenis Wajib Deskripsi
Sumber string benar URL ke gambar. ms-appx, ms-appdata, dan http didukung. Gambar http harus berukuran 200 KB atau kurang.
HintOverlay Int? salah Baru di 1511: Overlay hitam pada gambar intip. Nilai ini mengontrol keburaman overlay hitam, dengan 0 tidak ada overlay dan 100 menjadi benar-benar hitam. Default ke 20. Pada versi sebelumnya, nilai ini akan diabaikan dan gambar intip akan ditampilkan dengan 0 overlay.
HintCrop TilePeekImageCrop salah Baru di 1511: Tentukan bagaimana Anda ingin gambar dipotong. Dalam versi sebelum 1511, ini akan diabaikan dan gambar intip akan ditampilkan tanpa pemotongan apa pun.
Teks Alternatif string salah Teks alternatif yang menjelaskan gambar, digunakan untuk tujuan aksesibilitas.
AddImageQuery Bool? salah Atur ke "true" untuk memungkinkan Windows menambahkan string kueri ke URL 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" yang diberikan dalam pemberitahuan menjadi "www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us"

TilePeekImageCrop

Mengontrol pemotongan gambar intip.

Value Makna
Default Pemotongan menggunakan perilaku default perender.
Tidak Gambar tidak dipotong, ditampilkan persegi.
Lingkaran Gambar dipangkas ke lingkaran.

TileTextStacking

Penumpukan teks menentukan perataan vertikal konten.

Value Makna
Default Nilai default. Perender secara otomatis memilih perataan vertikal default.
Atas Rata vertikal ke bagian atas.
Pusat Rata vertikal ke tengah.
Bawah Rata vertikal ke bagian bawah.

TileBindingContentIconic

Didukung pada Kecil dan Sedang. Mengaktifkan templat petak peta ikonik, di mana Anda dapat memiliki ikon dan tampilan lencana di samping satu sama lain pada petak peta, dalam gaya Windows Telepon klasik yang sebenarnya. Angka di samping ikon dicapai melalui pemberitahuan lencana terpisah.

Properti Jenis Wajib Deskripsi
Ikon TileBasicImage benar Minimal, untuk mendukung petak peta Desktop dan Seluler, Kecil dan Sedang, berikan gambar rasio aspek persegi dengan resolusi 200x200, format PNG, dengan transparansi dan tidak ada warna selain putih. Untuk informasi selengkapnya lihat: Templat Petak Peta Khusus.

TileBindingContentContact

Hanya ponsel. Didukung pada Kecil, Sedang, dan Lebar.

Properti Jenis Wajib Deskripsi
Gambar TileBasicImage benar Gambar yang akan ditampilkan.
Teks TileBasicText salah Baris teks yang ditampilkan. Tidak ditampilkan pada petak peta kecil.

TileBindingContent Orang

Baru di 1511: Didukung pada Sedang, Lebar, dan Besar (Desktop dan Seluler). Sebelumnya ini hanya Seluler dan hanya Sedang dan Lebar.

Properti Jenis Wajib Deskripsi
Citra IList<TileBasicImage> benar Gambar yang akan berputar sebagai lingkaran.

TileBindingContentPhotos

Menganimasikan melalui tayangan slide foto. Didukung pada semua ukuran.

Properti Jenis Wajib Deskripsi
Citra IList<TileBasicImage> benar Hingga 12 gambar dapat disediakan (Seluler hanya akan menampilkan hingga 9), yang akan digunakan untuk peragaan slide. Menambahkan lebih dari 12 akan melemparkan pengecualian.

TileBasicImage

Gambar yang digunakan pada berbagai templat khusus.

Properti Jenis Wajib Deskripsi
Sumber string benar URL ke gambar. ms-appx, ms-appdata, dan http didukung. Gambar http harus berukuran 200 KB atau kurang.
Teks Alternatif string salah Teks alternatif yang menjelaskan gambar, digunakan untuk tujuan aksesibilitas.
AddImageQuery Bool? salah Atur ke "true" untuk memungkinkan Windows menambahkan string kueri ke URL 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" yang diberikan dalam pemberitahuan menjadi "www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us"

TileBasicText

Elemen teks dasar yang digunakan pada berbagai templat khusus.

Properti Jenis Wajib Deskripsi
Teks string salah Teks yang akan ditampilkan.
Bahasa string salah Lokal target payload XML, ditentukan sebagai tag bahasa BCP-47 seperti "en-US" atau "fr-FR". Lokal yang ditentukan di sini mengambil alih lokal lain yang ditentukan, seperti dalam pengikatan atau visual. Jika nilai ini adalah string literal, 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.