ToastNotificationManager Kelas

Referensi

Definisi

Ruang nama:: Windows.UI.Notifications

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Edit

Membuat objek ToastNotifier yang Anda gunakan untuk menaikkan pemberitahuan toast. Kelas ini juga menyediakan akses ke konten XML templat toast yang disediakan sistem sehingga Anda dapat menyesuaikan konten tersebut untuk digunakan dalam pemberitahuan Anda.

public ref class ToastNotificationManager abstract sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
class ToastNotificationManager final

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class ToastNotificationManager final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
public static class ToastNotificationManager

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public static class ToastNotificationManager

Public Class ToastNotificationManager

Warisan: Object Platform::Object IInspectable ToastNotificationManager

Atribut: 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)

Contoh

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

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(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);

Keterangan

Mengirim pemberitahuan toast dari aplikasi desktop

Umumnya, mengirim pemberitahuan toast dari aplikasi desktop sama dengan mengirimkannya dari aplikasi UWP. Namun, Anda harus mengetahui perbedaan dan persyaratan ini:

Agar aplikasi desktop menampilkan toast, aplikasi harus memiliki pintasan di layar Mulai.
Pintasan harus memiliki AppUserModelID.
Aplikasi desktop tidak dapat menjadwalkan toast.

Untuk mengetahui informasi selengkapnya, lihat topik berikut:

Riwayat versi

Versi Windows	Versi SDK	Nilai ditambahkan
1607	14393	MengonfigurasiNotificationMirroring
1607	14393	GetForUser
1703	15063	GetDefault

Properti

History

Mendapatkan objek ToastNotificationHistory .

Metode

ConfigureNotificationMirroring(NotificationMirroring)	Menentukan apakah pencerminan pemberitahuan diizinkan. Pencerminan pemberitahuan memungkinkan pemberitahuan disiarkan di beberapa perangkat.
CreateToastNotifier()	Membuat dan menginisialisasi instans baru ToastNotification, yang terikat ke aplikasi panggilan, yang memungkinkan Anda menaikkan pemberitahuan toast ke aplikasi tersebut.
CreateToastNotifier(String)	Membuat dan menginisialisasi instans baru ToastNotification, terikat ke aplikasi tertentu, biasanya aplikasi lain dalam paket yang sama.
GetDefault()	Mendapatkan manajer pemberitahuan toast untuk pengguna saat ini.
GetForUser(User)	Mendapatkan manajer pemberitahuan toast untuk pengguna yang ditentukan.
GetTemplateContent(ToastTemplateType)	Mendapatkan konten XML dari salah satu templat toast yang telah ditentukan sebelumnya sehingga Anda bisa menyesuaikannya untuk digunakan dalam pemberitahuan Anda.

Berlaku untuk

Bagikan melalui