ToastNotificationManager Class

Crée les objets ToastNotifier utilisés pour générer des notifications contextuelles. Cette classe fournit également l'accès au contenu XML des modèles de toast fournis par le système pour vous permettre de personnaliser ce contenu pour l'utiliser dans la mise à jour de vos notifications.

Syntaxe


var toastNotificationManager = Windows.UI.Notifications.ToastNotificationManager;

Attributs

[DualApiPartition()]
[Threading(MTA)]
[Version(0x06020000)]

Membres

ToastNotificationManagerClasse possède ces types de membres :

Méthodes

The ToastNotificationManager Classe a les méthodes suivantes. Avec C#, Visual Basic et C++, elle hérite également des méthodes de Object Classe.

MéthodeDescription
CreateToastNotifier() Creates and initializes a new instance of the ToastNotification, bound to the calling application, that lets you raise a toast notification to that app.
CreateToastNotifier(String) Creates and initializes a new instance of the ToastNotification, bound to a specified app, usually another app in the same package.
GetTemplateContent Gets the XML content of one of the predefined toast templates so that you can customize it for use in your notification.

 

Remarques

Envoi de notifications de toast à partir d'applications bureautiques

En général, l'envoi d'une notification contextuelle à partir d'une application de bureau ou à partir d'une application Windows Store est identique. Toutefois, vous devez tenir compte de ces différences et spécifications :

  • Pour qu'une application de bureau affiche un toast, l'application doit avoir un raccourci sur l'écran de démarrage.
  • Le raccourci doit avoir un AppUserModelID.
  • Les applications bureautiques ne peuvent pas planifier un toast.

Pour plus d'informations, consultez les rubriques suivantes :

Exemples

L'exemple suivant montre comment créer et envoyer une notification de toast qui comprend du texte et des images, notamment comment utiliser les méthodes GetTemplateContent et 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);

Conditions requises

Client minimal pris en charge

Windows 8 [Applications Windows Store, applications de bureau]

Serveur minimal pris en charge

Windows Server 2012 [Applications Windows Store, applications de bureau]

Espace de noms

Windows.UI.Notifications
Windows::UI::Notifications [C++]

Métadonnées

Windows.winmd

Voir aussi

Exemple de notifications de toast
Exemple d'envoi de notifications de toast à partir d'applications de bureau
Schéma XML de toast
Vue d'ensemble de la notification de toast
Démarrage rapide : envoi d'une notification de toast
Démarrage rapide : envoi d'une notification de type push de toast
Démarrage rapide : envoi d'une notification de toast à partir du Bureau
Instructions et liste de contrôle pour les notifications de toast
Comment gérer l'activation à partir d'une notification de toast
Comment opter pour les notifications de toast
Comment planifier une notification de toast
Comment activer les notifications de toast de bureau via un AppUserModelID
Catalogue des modèles de toast
Options audio de toast

 

 

Afficher:
© 2015 Microsoft