Schnellstart: Senden einer Popupbenachrichtigung vom Desktop

In dieser Schnellstartanleitung erfahren Sie, wie Sie eine Popupbenachrichtigung von einer Desktop-App aus erstellen.

Voraussetzungen

  • Bibliotheken
    • C++: Runtime.object.lib
    • C # : Windows. Winmd
  • Eine Verknüpfung mit Ihrer App mit einemSystem.AppUserModel.ID muss auf dem Computer installiert Startbildschirm. Beachten Sie jedoch, dass sie nicht an den -Code angeheftet Startbildschirm. Weitere Informationen finden Sie unter Aktivieren von Desktop-Popupbenachrichtigungen über eine AppUserModelID.
  • Eine Version von Microsoft Visual Studio, die mindestens Windows 8

Instructions

1. Erstellen Ihres Popupinhalts

Hinweis

Wenn Sie eine Popupvorlage angeben, die ein Image enthält, beachten Sie, dass Desktop-Apps nur lokale Images verwenden können. Webbilder 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 Fehler. Eine Desktop-App muss mindestens das Activated-Ereignis abonnieren, damit sie die erwartete Aktivierung der App aus dem Popup verarbeiten kann, wenn der Benutzer sie auswählt.

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

3. Senden des Popups

Wichtig

Jedes Mal, wenn Sie CreateToastNotifieraufrufen, müssen Sie die AppUserModelID der Verknüpfung Ihrer App auf dem Startbildschirm hinzufügen. Wenn Sie dies nicht tun, wird Ihr Popup nicht angezeigt.

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

4. Verarbeiten der Rückrufe

Bringen Sie das Fenster Ihrer App in den Vordergrund, wenn sie einen "aktivierten" Rückruf von der Popupbenachrichtigung empfängt. Wenn ein Benutzer ein Popup auswählt, wird erwartet, dass die App in eine Ansicht gestartet wird, die sich auf den Inhalt dieses Popups bezieht.

Beispiel zum Senden von Toastbenachrichtigungen aus Desktop-Apps

Aktivieren von Desktoppopupbenachrichtigungen über eine AppUserModelID

Popup-XML-Schema

Übersicht über Popupbenachrichtigungen

Schnellstart: Senden einer Popupbenachrichtigung

Schnellstart: Senden einer Popup-Pushbenachrichtigung

Richtlinien und Checkliste für Popupbenachrichtigungen

Auswählen und Verwenden einer Popupvorlage

Behandeln der Aktivierung von Popupbenachrichtigungen

Aktivieren von Popupbenachrichtigungen

Auswählen einer Popupvorlage

Audiooptionen für Popups