Guida introduttiva: Invio di una notifica di tipo avviso popup dal desktop
Questa guida introduttiva illustra come generare una notifica di tipo avviso popup da un'app desktop.
Prerequisiti
- Librerie
- C++: Runtime.object.lib
- C#: Windows.Winmd
- Un collegamento all'app, con un System.AppUserModel.ID, deve essere installato nella schermata Start. Si noti, tuttavia, che non è necessario aggiungerlo alla schermata Start. Per altre informazioni, vedere Come abilitare le notifiche di tipo avviso popup desktop tramite AppUserModelID.
- Versione di Microsoft Visual Studio che supporta almeno Windows 8
Istruzioni
1. Creare il contenuto dell'avviso popup
Nota
Quando si specifica un modello di avviso popup che include un'immagine, tenere 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
Registrare i gestori per gli eventi di tipo avviso popup: 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 l'avviso popup
Importante
Devi includere l'AppUserModelID del collegamento dell'app nella schermata Start ogni volta che chiami CreateToastNotifier. Se non si riesce a eseguire questa operazione, l'avviso popup non verrà visualizzato.
ToastNotificationManager.CreateToastNotifier(appID).Show(toast);
4. Gestire i callback
Portare la finestra dell'app in primo piano se riceve un callback "attivato" dalla notifica di tipo avviso popup. Quando un utente seleziona un avviso popup, l'aspettativa è che l'app verrà avviata a una visualizzazione correlata al contenuto dell'avviso popup.
Argomenti correlati
-
Esempio di invio notifiche di tipo avviso popup da app desktop
-
Come abilitare le notifiche di tipo avviso popup sul desktop tramite un AppUserModelID
-
Guida introduttiva: Invio di una notifica di tipo avviso popup
-
Guida introduttiva: Invio di una notifica push di tipo avviso popup
-
Linee guida ed elenco di controllo per le notifiche di tipo avviso popup
-
Come gestire l'attivazione da una notifica di tipo avviso popup
-
Come acconsentire esplicitamente alle notifiche di tipo avviso popup