ScheduledToastNotification Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Contient le code XML qui définit la notification toast qui s’affichera à l’heure planifiée.
public ref class ScheduledToastNotification sealed/// [Windows.Foundation.Metadata.Activatable(Windows.UI.Notifications.IScheduledToastNotificationFactory, 65536, Windows.Foundation.UniversalApiContract)]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
class ScheduledToastNotification final/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
/// [Windows.Foundation.Metadata.Activatable(Windows.UI.Notifications.IScheduledToastNotificationFactory, 65536, "Windows.Foundation.UniversalApiContract")]
class ScheduledToastNotification final/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
/// [Windows.Foundation.Metadata.Activatable(Windows.UI.Notifications.IScheduledToastNotificationFactory, 65536, "Windows.Foundation.UniversalApiContract")]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class ScheduledToastNotification final[Windows.Foundation.Metadata.Activatable(typeof(Windows.UI.Notifications.IScheduledToastNotificationFactory), 65536, typeof(Windows.Foundation.UniversalApiContract))]
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
public sealed class ScheduledToastNotification[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.IScheduledToastNotificationFactory), 65536, "Windows.Foundation.UniversalApiContract")]
public sealed class ScheduledToastNotification[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.IScheduledToastNotificationFactory), 65536, "Windows.Foundation.UniversalApiContract")]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class ScheduledToastNotificationfunction ScheduledToastNotification(content, deliveryTime, snoozeInterval, maximumSnoozeCount)Public NotInheritable Class ScheduledToastNotification- Héritage
- Attributs
Configuration requise pour Windows
| Famille d’appareils |
Windows 10 (introduit dans 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
|
| API contract |
Windows.Foundation.UniversalApiContract (introduit dans v1.0)
|
Exemples
L’exemple suivant montre une notification toast planifiée pour s’afficher dans une heure.
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);
Remarques
Créez et initialisez une nouvelle instance de cet objet en appelant ScheduledToastNotification.
Historique des versions
| Version de Windows | Version du SDK | Valeur ajoutée |
|---|---|---|
| 1607 | 14393 | NotificationMirroring |
| 1607 | 14393 | RemoteId |
| 1803 | 17134 | ExpirationTime |
Constructeurs
| ScheduledToastNotification(XmlDocument, DateTime) |
Crée et initialise une nouvelle instance d’une scheduledToastNotification qui ne sera affichée qu’une seule fois. |
| ScheduledToastNotification(XmlDocument, DateTime, TimeSpan, UInt32) |
Déconseillé dans Windows 10. Sur Windows 8 systèmes, crée et initialise une nouvelle instance d’un ScheduledToastNotification qui réapparaît après une heure spécifiée après l’apparition initiale. Sur Windows 10, cela fonctionne de manière équivalente à ScheduledToastNotification(XmlDocument, DateTime). Pour obtenir le même comportement d’intervalle de veille dans Windows 10, vous pouvez utiliser des boutons sur vos toasts. |
Propriétés
| Content |
Obtient le code XML qui définit cette notification toast planifiée. |
| DeliveryTime |
Obtient l’heure à laquelle cette notification toast est planifiée pour être affichée. |
| ExpirationTime |
Obtient ou définit l’heure d’expiration de la notification. |
| Group |
Obtient ou définit l’identificateur de groupe pour la notification. |
| Id |
Obtient une valeur spécifiée par le développeur utilisée pour identifier un toast planifié spécifique. |
| MaximumSnoozeCount |
Obtient le nombre maximal de fois pour afficher cette notification. |
| NotificationMirroring |
Obtient ou définit une valeur qui spécifie si la mise en miroir des notifications est activée. (La mise en miroir de notifications permet à une notification d’apparaître sur plusieurs appareils.) |
| RemoteId |
Obtient ou définit un ID distant pour la notification qui permet au système de mettre en corrélation cette notification avec une autre générée sur un autre appareil. |
| SnoozeInterval |
Obtient la durée entre les occurrences de la notification. |
| SuppressPopup |
Obtient ou définit si l’interface utilisateur contextuelle d’un toast s’affiche sur l’écran de l’utilisateur. |
| Tag |
Obtient ou définit une chaîne qui identifie de manière unique une notification toast à l’intérieur d’un groupe. |