Condividi tramite

Guida introduttiva: Invio di una notifica toast dal desktop

  • Articolo

Guida rapida mostra come creare una notifica toast da un'app desktop.

Prerequisiti

Disposizioni

1. Crea il contenuto del toast

Nota

Quando specifichi un modello di avviso popup che include un'immagine, tieni presente che le app desktop possono usare solo immagini locali; le immagini Web non sono supportate. Inoltre, il percorso del file di immagine locale deve essere fornito come percorso assoluto (non relativo).

 

// 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. Creare e collegare i gestori eventi

Registra gli handler per gli eventi di tipo toast: Attivato, Ignorato e Non riuscito. Un'app desktop deve almeno sottoscrivere l'evento Activated in modo che possa gestire l'attivazione prevista dell'app dall'avviso popup quando l'utente lo seleziona.

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

3. Inviare il toast

Importante

Dovresti includere l'AppUserModelID del collegamento dell'app sulla schermata Start ogni volta che chiami CreateToastNotifier. Se non riesci a fare questo, il toast non verrà visualizzato.

 

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

4. Gestire i callback

Porta la finestra dell'app in primo piano se riceve un callback di "attivazione" dalla notifica toast. Quando un utente seleziona una notifica, ci si aspetta che l'app venga avviata su una schermata correlata al contenuto della notifica.

Invio di notifiche toast da le app desktop

Come abilitare le notifiche di tipo avviso popup desktop tramite un AppUserModelID

Schema XML Toast

Panoramica delle notifiche toast

Avvio rapido : Invio di una notifica "toast" (Quickstart)

Avvio rapido : Invio di una notifica toast push

Linee guida ed elenco di controllo per le notifiche di tipo avviso popup

Come scegliere e usare un modello di toast

Come gestire l'attivazione da una notifica toast

Come abilitare le notifiche toast

Scelta di un modello di notifica

Opzioni audio per notifica a comparsa