Partager via

Démarrage rapide : Envoi d’une notification toast à partir du bureau

  • Article

Ce guide de démarrage rapide montre comment déclencher une notification toast à partir d’une application de bureau.

Prérequis

Instructions

1. Créer votre contenu toast

Notes

Lorsque vous spécifiez un modèle toast qui inclut une image, n’oubliez pas que les applications de bureau peuvent utiliser uniquement des images locales ; les images web ne sont pas prises en charge. En outre, le chemin d’accès au fichier image local doit être fourni en tant que chemin d’accès absolu (non relatif).

 

// Get a toast XML template
XmlDocument toastXml = ToastNotificationManager.GetTemplateContent(ToastTemplateType.ToastImageAndText04);

// Fill in the text elements
XmlNodeList stringElements = toastXml.GetElementsByTagName("text");
for (int i = 0; i < stringElements.Length; i++)
{
    stringElements[i].AppendChild(toastXml.CreateTextNode("Line " + i));
}

// Specify the absolute path to an image
String imagePath = "file:///" + Path.GetFullPath("toastImageAndText.png");
XmlNodeList imageElements = toastXml.GetElementsByTagName("image");

ToastNotification toast = new ToastNotification(toastXml);

2. Créer et attacher les gestionnaires d’événements

Inscrivez des gestionnaires pour les événements toast : Activé, Ignoré et Échec. Une application de bureau doit au moins s’abonner à l’événement Activated pour pouvoir gérer l’activation attendue de l’application à partir du toast lorsque l’utilisateur la sélectionne.

toast.Activated += ToastActivated;
toast.Dismissed += ToastDismissed;
toast.Failed += ToastFailed;

3. Envoyer le toast

Important

Vous devez inclure l’AppUserModelID du raccourci de votre application sur l’écran d’accueil chaque fois que vous appelez CreateToastNotifier. Si vous ne le faites pas, votre toast ne s’affiche pas.

 

ToastNotificationManager.CreateToastNotifier(appID).Show(toast);

4. Gérer les rappels

Placez la fenêtre de votre application au premier plan si elle reçoit un rappel « activé » de la notification toast. Lorsqu’un utilisateur sélectionne un toast, il s’attend à ce que l’application soit lancée dans une vue liée au contenu de ce toast.

Exemple d’envoi de notifications toast à partir d’applications de bureau

Guide pratique pour activer les notifications toast de bureau via un AppUserModelID

Schéma XML toast

Vue d’ensemble des notifications Toast

Démarrage rapide : Envoi d’une notification toast

Démarrage rapide : Envoi d’une notification Push toast

Recommandations et liste de contrôle pour les notifications toast

Comment choisir et utiliser un modèle toast

Comment gérer l’activation à partir d’une notification toast

Comment opter pour les notifications toast

Choix d’un modèle toast

Options audio toast