Skema konten toast

Berikut ini menjelaskan semua properti dan elemen dalam konten toast.

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

ToastContent

ToastContent

ToastContent adalah objek tingkat atas yang menjelaskan konten pemberitahuan, termasuk visual, tindakan, dan audio.

Properti Jenis Diperlukan Deskripsi
Luncurkan string salah String yang diteruskan ke aplikasi saat diaktifkan oleh Toast. Format dan konten string ini ditentukan oleh aplikasi untuk penggunaannya sendiri. Saat pengguna mengetuk atau mengeklik Toast untuk meluncurkan aplikasi terkait, string peluncuran menyediakan konteks ke aplikasi yang memungkinkannya menampilkan tampilan yang relevan dengan konten Toast kepada pengguna, daripada meluncurkan dengan cara defaultnya.
Visual ToastVisual benar Menjelaskan bagian visual dari pemberitahuan toast.
Tindakan IToastActions salah Secara opsional buat tindakan kustom dengan tombol dan input.
Audio ToastAudio salah Menjelaskan bagian audio dari pemberitahuan toast.
ActivationType ToastActivationType salah Menentukan jenis aktivasi apa yang akan digunakan ketika pengguna mengklik isi Toast ini.
ActivationOptions ToastActivationOptions salah Baru di Pembaruan Pembuat: Opsi tambahan yang berkaitan dengan aktivasi pemberitahuan toast.
Skenario ToastScenario salah Menyatakan skenario yang digunakan toast Anda, seperti alarm atau pengingat.
DisplayTimestamp DateTimeOffset? salah Baru di Pembaruan Pembuat: Ganti tanda waktu default dengan tanda waktu kustom yang mewakili kapan konten pemberitahuan Anda benar-benar dikirimkan, bukan waktu pemberitahuan diterima oleh platform Windows.
Header ToastHeader salah Baru di Pembaruan Pembuat: Tambahkan header kustom ke pemberitahuan Anda untuk mengelompokkan beberapa pemberitahuan bersama-sama dalam Pusat Tindakan.

ToastScenario

Menentukan skenario apa yang diwakili toast.

Nilai Makna
Default Perilaku toast normal.
Pengingat Pemberitahuan pengingat. Ini akan ditampilkan sebelum diperluas dan tetap berada di layar pengguna sampai diberhentikan.
Alarm Pemberitahuan alarm. Ini akan ditampilkan sebelum diperluas dan tetap berada di layar pengguna sampai diberhentikan. Audio akan diulang secara default dan akan menggunakan audio alarm.
IncomingCall Pemberitahuan panggilan masuk. Ini akan ditampilkan sebelum diperluas dalam format panggilan khusus dan tetap berada di layar pengguna sampai diberhentikan. Audio akan diulang secara default dan akan menggunakan audio nada dering.

ToastVisual

Bagian visual toast berisi pengikatan, yang berisi teks, gambar, konten adaptif, dan banyak lagi.

Properti Jenis Diperlukan Deskripsi
BindingGeneric ToastBindingGeneric benar Pengikatan toast generik, yang dapat dirender di semua perangkat. Pengikatan ini diperlukan dan tidak boleh null.
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.

ToastBindingGeneric

Pengikatan generik adalah pengikatan default untuk toast, dan merupakan tempat Anda menentukan teks, gambar, konten adaptif, dan banyak lagi.

Properti Jenis Diperlukan Deskripsi
Anak-anak IList<IToastBindingGenericChild> salah Isi isi Toast, yang dapat mencakup teks, gambar, dan grup (ditambahkan dalam Anniversary Update). Elemen teks harus datang sebelum elemen lain, dan hanya 3 elemen teks yang didukung. Jika elemen teks ditempatkan setelah elemen lain, elemen tersebut akan ditarik ke bagian atas atau dijatuhkan. Dan akhirnya, properti teks tertentu seperti HintStyle tidak didukung pada elemen teks anak akar, dan hanya berfungsi di dalam AdaptiveSubgroup. Jika Anda menggunakan AdaptiveGroup pada perangkat tanpa Anniversary Update, konten grup hanya akan dihilangkan.
AppLogoOverride ToastGenericAppLogo salah Logo opsional untuk mengambil alih logo aplikasi.
HeroImage ToastGenericHeroImage salah Gambar "hero" unggulan opsional yang ditampilkan pada toast dan di dalam Action Center.
Attribution ToastGenericAttributionText salah Teks atribusi opsional yang akan ditampilkan di bagian bawah pemberitahuan toast.
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.

IToastBindingGenericChild

Antarmuka penanda untuk elemen anak toast yang menyertakan teks, gambar, grup, dan lainnya.

Implementasi
AdaptiveText
AdaptiveImage
AdaptiveGroup
AdaptiveProgressBar

AdaptiveText

Elemen teks adaptif. Jika ditempatkan di tingkat atas ToastBindingGeneric.Children, hanya HintMaxLines yang akan diterapkan. Tetapi jika ini ditempatkan sebagai anak dari grup/subgrup, gaya teks lengkap didukung.

Properti Jenis Diperlukan Deskripsi
Teks string atau BindableString salah Teks yang akan ditampilkan. Dukungan pengikatan data ditambahkan di Pembaruan Pembuat, tetapi hanya berfungsi untuk elemen teks tingkat atas.
HintStyle AdaptiveTextStyle salah Gaya mengontrol ukuran, berat, dan tingkat keburaman font teks. Hanya berfungsi untuk elemen teks di dalam grup/subgrup.
HintWrap bool? salah Atur ini ke true untuk mengaktifkan pembungkusan teks. Elemen teks tingkat atas mengabaikan properti ini dan selalu membungkus (Anda dapat menggunakan HintMaxLines = 1 untuk menonaktifkan pembungkusan untuk elemen teks tingkat atas). Elemen teks di dalam grup/subgrup default ke false untuk pembungkusan.
HintMaxLines Int? salah Jumlah baris maksimum yang diizinkan untuk ditampilkan oleh elemen teks.
HintMinLines Int? salah Jumlah baris minimum yang harus ditampilkan elemen teks. Hanya berfungsi untuk elemen teks di dalam grup/subgrup.
HintAlign AdaptiveTextAlign salah Perataan horizontal teks. Hanya berfungsi untuk elemen teks di dalam grup/subgrup.
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.

BindableString

Nilai pengikatan untuk string.

Properti Jenis Diperlukan Deskripsi
BindingName string benar Mendapatkan atau mengatur nama yang memetakan ke nilai data pengikatan Anda.

AdaptiveTextStyle

Gaya teks mengontrol ukuran, berat, dan opasitas font. Tingkat keburamannya adalah 60% buram.

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

AdaptiveTextAlign

Mengontrol perataan horizontal teks.

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

AdaptiveImage

Gambar sebaris.

Properti Jenis Diperlukan 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 harus tidak lebih besar dari 200 KB.
HintCrop AdaptiveImageCrop salah Baru dalam Pembaruan Hari Jadi: Kontrol 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. Hanya berfungsi untuk gambar di dalam grup/subgrup.
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 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"

AdaptiveImageCrop

Menentukan pemotongan gambar yang diinginkan.

Nilai Makna
Default Nilai default. Perilaku pemotongan ditentukan oleh perender.
Tidak ada Gambar tidak dipangkas.
Lingkaran Gambar dipotong menjadi bentuk lingkaran.

AdaptiveImageAlign

Menentukan perataan horizontal untuk gambar.

Nilai Makna
Default Nilai default. Perilaku perataan ditentukan oleh perender.
Stretch Gambar meregang 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 di sebelah kanan, menampilkan gambar pada resolusi aslinya.

AdaptiveGroup

Baru dalam Pembaruan Hari Jadi: Grup secara semantik mengidentifikasi bahwa konten dalam grup harus ditampilkan secara keseluruhan, atau tidak ditampilkan jika tidak sesuai. Grup juga memungkinkan pembuatan beberapa kolom.

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

AdaptiveSubgroup

Baru dalam Pembaruan Hari Jadi: Subgrup adalah kolom vertikal yang dapat berisi teks dan gambar.

Properti Jenis Diperlukan Deskripsi
Anak-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-anak subgrup.

Implementasi
AdaptiveText
AdaptiveImage

AdaptiveSubgroupTextStacking

TextStacking menentukan perataan vertikal konten.

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

AdaptiveProgressBar

Baru di Pembaruan Pembuat: Bilah kemajuan. Hanya didukung pada toast di Desktop, build 15063 atau yang lebih baru.

Properti Jenis Diperlukan Deskripsi
Judul string atau BindableString salah Mendapatkan atau mengatur string judul opsional. Mendukung pengikatan data.
Nilai double atau AdaptiveProgressBarValue atau BindableProgressBarValue salah Mendapatkan atau mengatur nilai bilah kemajuan. Mendukung pengikatan data. Default ke 0.
ValueStringOverride string atau BindableString salah Mendapatkan atau mengatur string opsional yang akan ditampilkan alih-alih string persentase default. Jika ini tidak disediakan, sesuatu seperti "70%" akan ditampilkan.
Status string atau BindableString benar Mendapatkan atau mengatur string status (diperlukan), yang ditampilkan di bawah bilah kemajuan di sebelah kiri. String ini harus mencerminkan status operasi, seperti "Mengunduh..." atau "Menginstal..."

AdaptiveProgressBarValue

Kelas yang mewakili nilai bilah kemajuan.

Properti Jenis Diperlukan Deskripsi
Nilai double salah Mendapatkan atau menetapkan nilai (0,0 - 1,0) yang mewakili persentase selesai.
IsIndeterminate bool salah Mendapatkan atau menetapkan nilai yang menunjukkan apakah bilah kemajuan tidak ditentukan. Jika ini benar, Nilai akan diabaikan.

BindableProgressBarValue

Nilai bilah kemajuan yang dapat diikat.

Properti Jenis Diperlukan Deskripsi
BindingName string benar Mendapatkan atau mengatur nama yang memetakan ke nilai data pengikatan Anda.

Logo yang akan ditampilkan alih-alih logo aplikasi.

Properti Jenis Diperlukan Deskripsi
Sumber string benar URL ke gambar. ms-appx, ms-appdata, dan http didukung. Gambar http harus berukuran 200 KB atau kurang.
HintCrop ToastGenericAppLogoCrop salah Tentukan bagaimana Anda ingin gambar dipangkas.
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 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"

ToastGenericAppLogoCrop

Mengontrol pemotongan gambar logo aplikasi.

Nilai Makna
Default Pemotongan menggunakan perilaku default perender.
Tidak ada Gambar tidak dipangkas, ditampilkan persegi.
Lingkaran Gambar dipangkas menjadi lingkaran.

ToastGenericHeroImage

Gambar "hero" unggulan yang ditampilkan pada toast dan di dalam Action Center.

Properti Jenis Diperlukan 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 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"

ToastGenericAttributionText

Teks atribusi ditampilkan di bagian bawah pemberitahuan toast.

Properti Jenis Diperlukan Deskripsi
Teks string benar Teks yang akan ditampilkan.
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". Jika tidak disediakan, lokal sistem akan digunakan sebagai gantinya.

IToastActions

Antarmuka penanda untuk tindakan/input toast.

Implementasi
ToastActionsCustom
ToastActionsSnoozeAndDismiss

ToastActionsCustom

Menerapkan IToastActions

Buat tindakan dan input kustom Anda sendiri, menggunakan kontrol seperti tombol, kotak teks, dan input pilihan.

Properti Jenis Diperlukan Deskripsi
Input IList<IToastInput> salah Input seperti kotak teks dan input pilihan. Hanya hingga 5 input yang diizinkan.
Tombol IList<IToastButton> salah Tombol ditampilkan setelah semua input (atau berdampingan dengan input jika tombol digunakan sebagai tombol balasan cepat). Hanya hingga 5 tombol yang diizinkan (atau lebih sedikit jika Anda juga memiliki item menu konteks).
ContextMenuItems IList<ToastContextMenuItem> salah Baru di Pembaruan Hari Jadi: Item menu konteks kustom, memberikan tindakan tambahan jika pengguna mengklik kanan pemberitahuan. Anda hanya dapat menggabungkan hingga 5 tombol dan item menu konteks.

IToastInput

Antarmuka penanda untuk input toast.

Implementasi
ToastTextBox
ToastSelectionBox

ToastTextBox

Mengimplementasikan IToastInput

Kontrol kotak teks tempat pengguna dapat mengetik teks.

Properti Jenis Diperlukan Deskripsi
Id string benar Id diperlukan, dan digunakan untuk memetakan teks yang dimasukkan pengguna ke dalam pasangan kunci-nilai id/nilai yang nantinya digunakan aplikasi Anda.
Judul string salah Teks judul untuk ditampilkan di atas kotak teks.
PlaceholderContent string salah Teks tempat penampung yang akan ditampilkan pada kotak teks saat pengguna belum mengetik teks apa pun.
DefaultInput string salah Teks awal untuk ditempatkan di kotak teks. Biarkan null ini untuk kotak teks kosong.

ToastSelectionBox

Mengimplementasikan IToastInput

Kontrol kotak pilihan, yang memungkinkan pengguna memilih dari daftar dropdown opsi.

Properti Jenis Diperlukan Deskripsi
Id string benar Id diperlukan. Jika pengguna memilih item ini, Id ini akan diteruskan kembali ke kode aplikasi Anda, yang mewakili pilihan mana yang mereka pilih.
Konten string benar Konten diperlukan, dan merupakan string yang ditampilkan pada item pilihan.

ToastSelectionBoxItem

Item kotak pilihan (item yang bisa dipilih pengguna dari daftar drop-down).

Properti Jenis Diperlukan Deskripsi
Id string benar Id diperlukan, dan digunakan untuk memetakan teks yang dimasukkan pengguna ke dalam pasangan kunci-nilai id/nilai yang nantinya digunakan aplikasi Anda.
Judul string salah Teks judul untuk ditampilkan di atas kotak pilihan.
DefaultSelectionBoxItemId string salah Ini mengontrol item mana yang dipilih secara default, dan mengacu pada properti Id dari ToastSelectionBoxItem. Jika Anda tidak menyediakan ini, pilihan default akan kosong (pengguna tidak melihat apa-apa).
Item IList<ToastSelectionBoxItem> salah Item pilihan yang bisa dipilih pengguna di Kotak Pilihan ini. Hanya 5 item yang dapat ditambahkan.

IToastButton

Antarmuka penanda untuk tombol toast.

Implementasi
ToastButton
ToastButtonSnooze
ToastButtonDismiss

ToastButton

Mengimplementasikan IToastButton

Tombol yang dapat diklik pengguna.

Properti Jenis Diperlukan Deskripsi
Konten string benar Wajib diisi. Teks yang akan ditampilkan pada tombol .
Argumen string benar Wajib diisi. String argumen yang ditentukan aplikasi yang nantinya akan diterima aplikasi jika pengguna mengklik tombol ini.
ActivationType ToastActivationType salah Mengontrol tipe aktivasi apa yang akan digunakan tombol ini ketika diklik. Default ke Latar Depan.
ActivationOptions ToastActivationOptions salah Baru di Creators Update: Mendapatkan atau mengatur opsi tambahan yang berkaitan dengan aktivasi tombol toast.

ToastActivationType

Memutuskan jenis aktivasi yang akan digunakan saat pengguna berinteraksi dengan tindakan tertentu.

Nilai Makna
Depan Nilai default. Aplikasi latar depan Anda diluncurkan.
Latar belakang Tugas latar belakang yang sesuai (dengan asumsi Anda menyiapkan semuanya) dipicu, dan Anda dapat menjalankan kode di latar belakang (seperti mengirim pesan balasan cepat pengguna) tanpa mengganggu pengguna.
Protokol Luncurkan aplikasi lain menggunakan aktivasi protokol.

ToastActivationOptions

Baru di Pembaruan Pembuat: Opsi tambahan yang berkaitan dengan aktivasi.

Properti Jenis Diperlukan Deskripsi
AfterActivationBehavior ToastAfterActivationBehavior salah Baru dalam Fall Creators Update: Mendapatkan atau mengatur perilaku yang harus digunakan toast saat pengguna memanggil tindakan ini. Ini hanya berfungsi di Desktop, untuk ToastButton dan ToastContextMenuItem.
ProtocolActivationTargetApplicationPfn string salah Jika Anda menggunakan ToastActivationType.Protocol, Anda dapat secara opsional menentukan PFN target, sehingga terlepas dari apakah beberapa aplikasi terdaftar untuk menangani uri protokol yang sama, aplikasi yang Anda inginkan akan selalu diluncurkan.

ToastAfterActivationBehavior

Menentukan perilaku yang harus digunakan toast ketika pengguna mengambil tindakan pada toast.

Nilai Makna
Default Perilaku default. Roti panggang akan dimatikan ketika pengguna mengambil tindakan pada roti panggang.
PendingUpdate Setelah pengguna mengklik tombol pada toast Anda, pemberitahuan akan tetap ada, dalam status visual "pembaruan tertunda". Anda harus segera memperbarui toast Anda dari tugas latar belakang sehingga pengguna tidak melihat status visual "pembaruan tertunda" ini terlalu lama.

ToastButtonSnooze

Mengimplementasikan IToastButton

Tombol tunda yang ditangani sistem yang secara otomatis menangani tunda pemberitahuan.

Properti Jenis Diperlukan Deskripsi
CustomContent string salah Teks kustom opsional ditampilkan pada tombol yang mengambil alih teks "Tunda" yang dilokalkan default.

ToastButtonDismiss

Mengimplementasikan IToastButton

Tombol tutup yang ditangani sistem yang menutup pemberitahuan saat diklik.

Properti Jenis Diperlukan Deskripsi
CustomContent string salah Teks kustom opsional ditampilkan pada tombol yang mengambil alih teks "Tutup" yang dilokalkan default.

ToastActionsSnoozeAndDismiss

*Mengimplementasikan IToastActions

Secara otomatis membuat kotak pilihan untuk interval tunda, dan tombol tunda/tutup, semua logika yang dilokalkan secara otomatis, dan penundaan secara otomatis ditangani oleh sistem.

Properti Jenis Diperlukan Deskripsi
ContextMenuItems IList<ToastContextMenuItem> salah Baru di Pembaruan Hari Jadi: Item menu konteks kustom, memberikan tindakan tambahan jika pengguna mengklik kanan pemberitahuan. Anda hanya dapat memiliki hingga 5 item.

ToastContextMenuItem

Entri item menu konteks.

Properti Jenis Diperlukan Deskripsi
Konten string benar Wajib diisi. Teks yang akan ditampilkan.
Argumen string benar Wajib diisi. String argumen yang ditentukan aplikasi yang nantinya dapat diambil aplikasi setelah diaktifkan saat pengguna mengklik item menu.
ActivationType ToastActivationType salah Mengontrol tipe aktivasi apa yang akan digunakan item menu ini ketika diklik. Default ke Latar Depan.
ActivationOptions ToastActivationOptions salah Baru di Pembaruan Pembuat: Opsi tambahan yang berkaitan dengan aktivasi item menu konteks toast.

ToastAudio

Tentukan audio yang akan diputar saat pemberitahuan Toast diterima.

Properti Jenis Diperlukan Deskripsi
Src uri salah Berkas media yang akan diputar sebagai pengganti suara asali. Hanya ms-appx dan ms-resource yang didukung. Semua lainnya (ms-appdata, http, C:, dll.) tidak didukung.
Perulangan boolean salah Atur ke true jika suara harus diulang selama Toast ditampilkan; false untuk diputar hanya sekali (default).
Diam boolean salah Benar untuk membisukan suara; false untuk memungkinkan suara pemberitahuan toast diputar (default).

ToastHeader

Baru di Pembaruan Pembuat: Header kustom yang mengelompokkan beberapa pemberitahuan bersama-sama dalam Pusat Tindakan.

Properti Jenis Diperlukan Deskripsi
Id string benar Pengidentifikasi yang dibuat pengembang yang secara unik mengidentifikasi header ini. Jika dua pemberitahuan memiliki id header yang sama, mereka akan ditampilkan di bawah header yang sama di Pusat Tindakan.
Judul string benar Judul untuk header .
Argumen string benar Mendapatkan atau mengatur string argumen yang ditentukan pengembang yang dikembalikan ke aplikasi saat pengguna mengklik header ini. Tidak boleh nihil.
ActivationType ToastActivationType salah Mendapatkan atau mengatur jenis aktivasi yang akan digunakan header ini saat diklik. Default ke Latar Depan. Perhatikan bahwa hanya Latar Depan dan Protokol yang didukung.
ActivationOptions ToastActivationOptions salah Mendapatkan atau mengatur opsi tambahan yang berkaitan dengan aktivasi header toast.