ToastNotification Kelas

Definisi

Ruang nama:

Windows.UI.Notifications

Menentukan konten, metadata dan peristiwa terkait, dan waktu kedaluwarsa pemberitahuan toast.

public ref class ToastNotification sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
/// [Windows.Foundation.Metadata.Activatable(Windows.UI.Notifications.IToastNotificationFactory, 65536, "Windows.Foundation.UniversalApiContract")]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class ToastNotification final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
[Windows.Foundation.Metadata.Activatable(typeof(Windows.UI.Notifications.IToastNotificationFactory), 65536, "Windows.Foundation.UniversalApiContract")]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class ToastNotification

function ToastNotification(content)

Public NotInheritable Class ToastNotification

Warisan

Object Platform::Object IInspectable ToastNotification

Atribut

ActivatableAttribute ContractVersionAttribute ThreadingAttribute MarshalingBehaviorAttribute

Persyaratan Windows

Rangkaian perangkat	Windows 10 (diperkenalkan dalam 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract	Windows.Foundation.UniversalApiContract (diperkenalkan dalam v1.0)

Keterangan

Untuk panduan cara menerapkan pemberitahuan toast di aplikasi Anda, lihat Mengirim pemberitahuan toast lokal dari aplikasi C#.

Panduan untuk menangani aktivasi aplikasi untuk pemberitahuan toast:

• Aplikasi UWP harus menggunakan OnActivated untuk menangani aktivasi toast.
• Dimulai dengan WinRT Build 19041, aplikasi yang dikemas (termasuk aplikasi paket dengan lokasi eksternal) dapat menggunakan ToastNotificationActionTrigger untuk menangani aktivasi untuk detail selengkapnya.
• Aplikasi desktop dapat menggunakan aktivasi COM dengan mengikuti Desktop - Kirim Toast Lokal.
• Jika tidak ada opsi aktivasi yang sesuai dengan aplikasi Anda, ikuti contoh dalam dokumen ini untuk menggunakan penanganan aktivitas dengan benar.

Riwayat versi

Versi Windows	Versi SDK	Nilai ditambahkan
1607	14393	NotificationMirroring
1607	14393	RemoteId
1703	15063	Data
1703	15063	Prioritas
1903	18362	ExpiresOnReboot

Konstruktor

ToastNotification(XmlDocument)

Membuat dan menginisialisasi instans baru ToastNotification.

Properti

Content	Mendapatkan XML yang menentukan pemberitahuan toast saat ini.
Data	Mendapatkan atau mengatur informasi tambahan tentang status pemberitahuan toast.
ExpirationTime	Mendapatkan atau mengatur waktu setelah pemberitahuan toast tidak boleh ditampilkan.
ExpiresOnReboot	Menunjukkan apakah pemberitahuan toast akan tetap berada di Pusat Pemberitahuan setelah boot ulang.
Group	Mendapatkan atau mengatur pengidentifikasi grup untuk pemberitahuan.
NotificationMirroring	Mendapatkan atau menetapkan nilai yang menentukan apakah pencerminan pemberitahuan diizinkan.
Priority	Mendapatkan atau mengatur prioritas pemberitahuan toast.
RemoteId	Mendapatkan atau mengatur id jarak jauh untuk pemberitahuan yang memungkinkan sistem menghubungkan pemberitahuan ini dengan yang lain yang dihasilkan pada perangkat lain.
SuppressPopup	Mendapatkan atau mengatur apakah UI pop-up toast ditampilkan di layar pengguna.
Tag	Mendapatkan atau mengatur pengidentifikasi unik pemberitahuan ini dalam Grup pemberitahuan.

Acara

Activated	Terjadi ketika pengguna mengaktifkan pemberitahuan toast melalui klik atau sentuhan. Aplikasi yang berjalan berlangganan kejadian ini.
Dismissed	Terjadi ketika pemberitahuan toast meninggalkan layar, baik dengan kedaluwarsa atau diberhentikan secara eksplisit oleh pengguna. Aplikasi yang berjalan berlangganan kejadian ini.
Failed	Terjadi ketika kesalahan disebabkan ketika Windows mencoba menaikkan pemberitahuan toast. Aplikasi yang berjalan berlangganan kejadian ini.

Lihat juga

• Sampel pemberitahuan toast
• Mengirim pemberitahuan toast dari sampel aplikasi desktop
• Skema XML toast
• Petak peta, lencana, dan pemberitahuan
• Mulai cepat: Mengirim pemberitahuan toast
• Mulai cepat: Mengirim pemberitahuan push toast
• Mulai cepat: Mengirim pemberitahuan toast dari desktop
• Panduan dan daftar periksa untuk pemberitahuan toast
• Cara menangani aktivasi dari pemberitahuan toast
• Cara ikut serta dalam pemberitahuan toast
• Cara menjadwalkan pemberitahuan toast
• Cara mengaktifkan pemberitahuan toast desktop melalui AppUserModelID
• Katalog templat roti panggang
• Opsi audio toast