ToastNotificationManager Kelas

  • Referensi

Definisi

Ruang nama:
Windows.UI.Notifications
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

Lihat juga