Schnellstart: Senden einer Popupbenachrichtigung vom Desktop
In dieser Schnellstartanleitung wird gezeigt, wie Sie eine Popupbenachrichtigung aus einer Desktop-App auslösen.
Voraussetzungen
- Bibliotheken
- C++: Runtime.object.lib
- C#: Windows.Winmd
- Auf dem Startbildschirm muss eine Verknüpfung zu Ihrer App mit einer System.AppUserModel.ID installiert werden. Beachten Sie jedoch, dass sie nicht an den Startbildschirm angeheftet werden muss. Weitere Informationen finden Sie unter Aktivieren von Desktop-Popupbenachrichtigungen über eine AppUserModelID.
- Eine Version von Microsoft Visual Studio, die mindestens Windows 8
Anweisungen
1. Erstellen Von Popupinhalten
Hinweis
Wenn Sie eine Popupvorlage angeben, die ein Image enthält, beachten Sie, dass Desktop-Apps nur lokale Bilder verwenden können. Webimages werden nicht unterstützt. Außerdem muss der Pfad zur lokalen Imagedatei als absoluter (nicht relativer) Pfad angegeben werden.
// 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. Erstellen und Anfügen der Ereignishandler
Registrieren Sie Handler für die Popupereignisse: Aktiviert, Verworfen und Fehlgeschlagen. Eine Desktop-App muss mindestens das Aktivierte Ereignis abonnieren, damit sie die erwartete Aktivierung der App über das Popup verarbeiten kann, wenn der Benutzer sie auswählt.
toast.Activated += ToastActivated;
toast.Dismissed += ToastDismissed;
toast.Failed += ToastFailed;
3. Senden des Popups
Wichtig
Sie müssen die AppUserModelID der Verknüpfung Ihrer App auf dem Startbildschirm jedes Mal einschließen, wenn Sie CreateToastNotifier aufrufen. Wenn Sie dies nicht tun, wird Ihr Popup nicht angezeigt.
ToastNotificationManager.CreateToastNotifier(appID).Show(toast);
4. Behandeln der Rückrufe
Bringen Sie das Fenster Ihrer App in den Vordergrund, wenn es einen "aktivierten" Rückruf von der Popupbenachrichtigung empfängt. Wenn ein Benutzer ein Popup auswählt, wird erwartet, dass die App in einer Ansicht gestartet wird, die sich auf den Inhalt dieses Popups bezieht.
Zugehörige Themen
-
Beispiel zum Senden von Toastbenachrichtigungen aus Desktop-Apps
-
Aktivieren von Desktoppopupbenachrichtigungen über eine AppUserModelID