ToastNotifier Kelas

Definisi

Ruang nama:

Windows.UI.Notifications

Menaikkan pemberitahuan toast ke aplikasi tertentu tempat ToastNotifier terikat. Kelas ini juga memungkinkan Anda menjadwalkan dan menghapus pemberitahuan toast.

public ref class ToastNotifier sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class ToastNotifier final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class ToastNotifier

Public NotInheritable Class ToastNotifier

Warisan

Object Platform::Object IInspectable ToastNotifier

Atribut

ContractVersionAttribute 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)

Contoh

Contoh berikut menunjukkan cara membuat dan mengirim pemberitahuan toast yang menyertakan teks dan gambar, termasuk penggunaan metode Tampilkan .

var notifications = Windows.UI.Notifications;

// Get the toast notification manager for the current app.
var notificationManager = notifications.ToastNotificationManager;

// The getTemplateContent method returns a Windows.Data.Xml.Dom.XmlDocument object
// that contains the toast notification XML content.
var template = notifications.ToastTemplateType.toastImageAndText01;
var toastXml = notificationManager.getTemplateContent(template);
var template = notifications.toastTemplateType.toastImageAndText01;
var toastXml = notificationManager.getTemplateContent(notifications.ToastTemplateType[template]);

// You can use the methods from the XML document to specify the required elements for the toast.
var images = toastXml.getElementsByTagName("image");
images[0].setAttribute("src", "images/toastImageAndText.png");

var textNodes = toastXml.getElementsByTagName("text");
textNodes.forEach(function (value, index) {
    var textNumber = index + 1;
    var text = "";
    for (var j = 0; j < 10; j++) {
        text += "Text input " + /*@static_cast(String)*/textNumber + " ";
    }
    value.appendChild(toastXml.createTextNode(text));
});

// Create a toast notification from the XML, then create a ToastNotifier object
// to send the toast.
var toast = new notifications.ToastNotification(toastXml);

notificationManager.createToastNotifier().show(toast);

Contoh berikut menunjukkan penggunaan metode GetScheduledToastNotifications dan RemoveFromSchedule .

var notifier = Notifications.ToastNotificationManager.createToastNotifier();
var scheduled = notifier.getScheduledToastNotifications();                    

for (var i = 0, len = scheduled.length; i < len; i++) {

    // The itemId value is the unique ScheduledTileNotification.Id assigned to the 
    // notification when it was created.
    if (scheduled[i].id === itemId) {
        notifier.removeFromSchedule(scheduled[i]);
    }
}

Keterangan

Saat dibuat, ToastNotifier terikat ke aplikasi tertentu, sehingga metode kelas ini hanya memengaruhi aplikasi tersebut.

Riwayat versi

Versi Windows	Versi SDK	Nilai ditambahkan
1703	15063	Update(NotificationData,String,String)
1703	15063	Update(NotificationData,String)
1809	17763	ScheduledToastNotificationShowing

Properti

Setting

Mendapatkan nilai yang memberi tahu Anda apakah ada aplikasi, pengguna, atau blok sistem yang mencegah tampilan pemberitahuan toast.

Metode

AddToSchedule(ScheduledToastNotification)	Menambahkan ScheduledToastNotification untuk ditampilkan nanti oleh Windows. Penting Metode ini hanya didukung dalam aplikasi yang menggunakan WinRT sebagai kerangka kerja aplikasi default mereka.
GetScheduledToastNotifications()	Mendapatkan koleksi objek ScheduledToastNotification yang telah dijadwalkan untuk ditampilkan oleh aplikasi ini. Penting Metode ini hanya didukung dalam aplikasi yang menggunakan WinRT sebagai kerangka kerja aplikasi default mereka.
Hide(ToastNotification)	Menghapus pemberitahuan toast yang ditentukan dari layar.
RemoveFromSchedule(ScheduledToastNotification)	Membatalkan tampilan terjadwal dari ScheduledToastNotification yang ditentukan. Penting Metode ini hanya didukung dalam aplikasi yang menggunakan WinRT sebagai kerangka kerja aplikasi default mereka.
Show(ToastNotification)	Menampilkan pemberitahuan toast yang ditentukan.
Update(NotificationData, String)	Updates pemberitahuan toast yang ada yang memiliki tag yang ditentukan.
Update(NotificationData, String, String)	Updates pemberitahuan toast yang ada yang memiliki tag yang ditentukan dan termasuk dalam grup pemberitahuan yang ditentukan.

Acara

ScheduledToastNotificationShowing

Terjadi ketika sistem menunjukkan pemberitahuan toast terjadwal.

Lihat juga

• Konten toast
• Skema konten toast
• Mengirim pemberitahuan toast lokal
• Sampel GitHub Pemberitahuan Windows