Bagikan melalui

ScheduledToastNotification Konstruktor

  • Referensi

Definisi

Ruang nama:
Windows.UI.Notifications

Overload

ScheduledToastNotification(XmlDocument, DateTime)

Membuat dan menginisialisasi instans baru ScheduledToastNotification yang hanya akan ditampilkan sekali.
ScheduledToastNotification(XmlDocument, DateTime, TimeSpan, UInt32)

Tidak digunakan lagi dalam Windows 10. Pada sistem Windows 8, membuat dan menginisialisasi instans baru ScheduledToastNotification yang muncul kembali setelah waktu yang ditentukan setelah awalnya muncul. Pada Windows 10, fungsi ini setara dengan ScheduledToastNotification(XmlDocument, DateTime). Untuk mencapai perilaku interval tunda yang sama dalam Windows 10, Anda dapat menggunakan tombol pada roti panggang Anda.

ScheduledToastNotification(XmlDocument, DateTime)

Edit

Membuat dan menginisialisasi instans baru ScheduledToastNotification yang hanya akan ditampilkan sekali.

public:
 ScheduledToastNotification(XmlDocument ^ content, DateTime deliveryTime);
 ScheduledToastNotification(XmlDocument const& content, DateTime const& deliveryTime);
public ScheduledToastNotification(XmlDocument content, System.DateTimeOffset deliveryTime);
function ScheduledToastNotification(content, deliveryTime)
Public Sub New (content As XmlDocument, deliveryTime As DateTimeOffset)

Parameter

content
XmlDocument

XML yang menentukan konten pemberitahuan toast.

deliveryTime
DateTime DateTimeOffset

Tanggal dan waktu Windows akan menampilkan pemberitahuan toast. Anda harus memanggil AddToSchedule sebelum waktu ini.

Contoh

Contoh berikut menunjukkan pemberitahuan toast yang dijadwalkan untuk ditampilkan dalam satu jam, termasuk penggunaan konstruktor ini untuk membuat pemberitahuan.

var Notifications = Windows.UI.Notifications;
var currentTime = new Date();
var seconds = 60;
var dueTime = new Date(currentTime.getTime() + seconds * 60 * 1000);
var idNumber = Math.floor(Math.random() * 100000000);  // Generates a unique ID number for the notification.

// Set up the notification text.
var toastXml = Notifications.ToastNotificationManager.getTemplateContent(Notifications.ToastTemplateType.toastText02);
var strings = toastXml.getElementsByTagName("text");
strings[0].appendChild(toastXml.createTextNode(This is a scheduled toast notification));
strings[1].appendChild(toastXml.createTextNode("Received: " + dueTime.toLocaleTimeString()));

// Create the toast notification object.
var toast = new Notifications.ScheduledToastNotification(toastXml, dueTime);
toast.id = "Toast" + idNumber;

// Add to the schedule.
Notifications.ToastNotificationManager.createToastNotifier().addToSchedule(toast);

Lihat juga

Berlaku untuk

ScheduledToastNotification(XmlDocument, DateTime, TimeSpan, UInt32)

Edit

Tidak digunakan lagi dalam Windows 10. Pada sistem Windows 8, membuat dan menginisialisasi instans baru ScheduledToastNotification yang muncul kembali setelah waktu yang ditentukan setelah awalnya muncul. Pada Windows 10, fungsi ini setara dengan ScheduledToastNotification(XmlDocument, DateTime). Untuk mencapai perilaku interval tunda yang sama dalam Windows 10, Anda dapat menggunakan tombol pada roti panggang Anda.

public:
 ScheduledToastNotification(XmlDocument ^ content, DateTime deliveryTime, TimeSpan snoozeInterval, unsigned int maximumSnoozeCount);
 ScheduledToastNotification(XmlDocument const& content, DateTime const& deliveryTime, TimeSpan const& snoozeInterval, uint32_t const& maximumSnoozeCount);
public ScheduledToastNotification(XmlDocument content, System.DateTimeOffset deliveryTime, System.TimeSpan snoozeInterval, uint maximumSnoozeCount);
function ScheduledToastNotification(content, deliveryTime, snoozeInterval, maximumSnoozeCount)
Public Sub New (content As XmlDocument, deliveryTime As DateTimeOffset, snoozeInterval As TimeSpan, maximumSnoozeCount As UInteger)

Parameter

content
XmlDocument

XML yang menentukan konten pemberitahuan toast.

deliveryTime
DateTime DateTimeOffset

Tanggal dan waktu windows harus terlebih dahulu menampilkan pemberitahuan toast. Anda harus memanggil AddToSchedule sebelum waktu ini.

snoozeInterval
TimeSpan TimeSpan

Jumlah waktu antara kemunculan pemberitahuan. Agar valid, nilai ini harus tidak kurang dari 60 detik dan tidak lebih dari 60 menit.

maximumSnoozeCount
UInt32

unsigned int

uint32_t

Jumlah maksimum waktu untuk menampilkan pemberitahuan ini. Nilai yang valid berkisar dari 1 hingga 5.

Contoh

Contoh berikut menunjukkan pemberitahuan toast yang dijadwalkan untuk ditampilkan dalam satu jam, termasuk penggunaan konstruktor ini untuk membuat pemberitahuan, menentukan interval tunda 60 detik dan maksimum lima kali untuk menampilkan pemberitahuan.

var Notifications = Windows.UI.Notifications;
var currentTime = new Date();
var seconds = 60;
var dueTime = new Date(currentTime.getTime() + seconds * 60 * 1000);
var idNumber = Math.floor(Math.random() * 100000000);  // Generates a unique ID number for the notification.

// Set up the notification text.
var toastXml = Notifications.ToastNotificationManager.getTemplateContent(Notifications.ToastTemplateType.toastText02);
var strings = toastXml.getElementsByTagName("text");
strings[0].appendChild(toastXml.createTextNode(This is a scheduled toast notification));
strings[1].appendChild(toastXml.createTextNode("Received: " + dueTime.toLocaleTimeString()));

// Create the toast notification object.
var toast = new Notifications.ScheduledToastNotification(toastXml, dueTime, 60 * 1000, 5);
toast.id = "Toast" + idNumber;

// Add to the schedule.
Notifications.ToastNotificationManager.createToastNotifier().addToSchedule(toast);

Keterangan

Jenis pemberitahuan toast terjadwal interval tunda ini baik untuk fungsionalitas seperti alarm tunda. Misalnya, pemberitahuan dapat ditampilkan setiap lima menit sampai jumlah tunda maksimum tercapai, kecuali pemberitahuan dihapus secara eksplisit dari jadwal oleh aplikasi Anda.

Penting

Aplikasi Anda bertanggung jawab untuk menghapus pemberitahuan dari jadwal setelah pengguna mengaktifkan pemberitahuan melalui sentuhan atau klik. Kegagalan untuk melakukannya dapat menyebabkan pemberitahuan muncul kembali sampai jumlah tunda maksimum tercapai, bahkan jika pengguna telah menanganinya.

Jika Anda ingin menjadwalkan interval tunda yang lama seperti bulan atau tahun, kami sarankan Anda menggunakan roti panggang terjadwal individual daripada metode ini. Itu akan menghindari kesalahan waktu yang disebabkan oleh waktu musim panas atau tahun kabisat.

Kode berikut menunjukkan panggilan ke metode ini yang menampilkan toast yang dimulai di myData setiap lima menit selama maksimal tiga kali.

new ScheduledToastNotification(toast1, myDate, 60000, 3)

Lihat juga

Berlaku untuk