Freigeben über

Popupheader

  • Artikel

Sie können eine Reihe verwandter Benachrichtigungen im Info-Center visuell gruppieren, indem Sie einen Popupheader für Ihre Benachrichtigungen verwenden.

Wichtig

Erfordert Desktop Creators Update und 1.4.0 der Benachrichtigungsbibliothek: Sie müssen Desktopbuild 15063 oder höher ausführen, um Popupheader anzuzeigen. Sie müssen Version 1.4.0 oder höher der UWP Community Toolkit Notifications NuGet-Bibliothek verwenden, um den Header im Inhalt Ihres Popups zu erstellen. Kopfzeilen werden nur auf Desktop unterstützt.

Wie unten gesehen, ist diese Gruppenunterhaltung unter einer einzigen Kopfzeile "Camping!!" vereinheitlicht. Jede einzelne Nachricht in der Unterhaltung ist eine separate Popupbenachrichtigung, die denselben Popupheader teilt.

Popups mit Kopfzeile

Sie können ihre Benachrichtigungen auch visuell nach Kategorie gruppieren, z. B. Flight-Erinnerungen, Paketverfolgung und vieles mehr.

Hinzufügen einer Kopfzeile zu einem Popup

Hier erfahren Sie, wie Sie einer Popupbenachrichtigung eine Kopfzeile hinzufügen.

Hinweis

Kopfzeilen werden nur auf Desktop unterstützt. Geräte, die Keine Header unterstützen, ignorieren einfach den Header.

new ToastContentBuilder()
    .AddHeader("6289", "Camping!!", "action=openConversation&id=6289")
    .AddText("Anyone have a sleeping bag I can borrow?");

Zusammenfassung...

  1. Hinzufügen der Kopfzeile zu " ToastContent"
  2. Zuweisen der erforderlichen ID-, Titel- und Argumenteigenschaften
  3. Senden Ihrer Benachrichtigung (weitere Informationen)
  4. Verwenden Sie in einer anderen Benachrichtigung dieselbe Header-ID, um sie unter der Kopfzeile zu vereinheitlichen. Die ID ist die einzige Eigenschaft, die verwendet wird, um zu bestimmen, ob die Benachrichtigungen gruppiert werden sollen, was bedeutet, dass titel und Argumente unterschiedlich sein können. Der Titel und die Argumente aus der letzten Benachrichtigung innerhalb einer Gruppe werden verwendet. Wenn diese Benachrichtigung entfernt wird, fällt der Titel und die Argumente auf die nächste letzte Benachrichtigung zurück.

Behandeln der Aktivierung aus einem Header

Kopfzeilen können von Benutzern geklickt werden, damit der Benutzer auf die Kopfzeile klicken kann, um mehr über Ihre App zu erfahren.

Daher können Apps Argumente für die Kopfzeile bereitstellen, ähnlich wie die Startargumente für das Popup selbst.

Die Aktivierung wird identisch mit der normalen Popupaktivierung behandelt, was bedeutet, dass Sie diese Argumente in der OnActivated-Methode App.xaml.cs abrufen können, genau wie sie tun, wenn der Benutzer auf den Textkörper Ihres Popups oder auf eine Schaltfläche auf dem Popup klickt.

protected override void OnActivated(IActivatedEventArgs e)
{
    // Handle toast activation
    if (e is ToastNotificationActivatedEventArgs)
    {
        // Arguments specified from the header
        string arguments = (e as ToastNotificationActivatedEventArgs).Argument;
    }
}

Zusätzliche Informationen

Die Kopfzeile trennt Benachrichtigungen visuell und gruppiert. Es ändert keine andere Logistik über die maximale Anzahl von Benachrichtigungen, die eine App haben kann (20) und das First-in-First-Out-Verhalten der Benachrichtigungsliste.

Die Reihenfolge der Benachrichtigungen in Kopfzeilen lautet wie folgt... Bei einer bestimmten App wird zuerst die letzte Benachrichtigung aus der App (und die gesamte Kopfzeilengruppe, falls Teil einer Kopfzeile) angezeigt.

Die ID kann eine beliebige Zeichenfolge sein, die Sie auswählen. Es gibt keine Längen- oder Zeichenbeschränkungen für eine der Eigenschaften in ToastHeader. Die einzige Einschränkung besteht darin, dass der gesamte XML-Popupinhalt nicht größer als 5 KB sein kann.

Das Erstellen von Kopfzeilen ändert nicht die Anzahl der im Info-Center angezeigten Benachrichtigungen, bevor die Schaltfläche "Mehr anzeigen" angezeigt wird (diese Zahl ist standardmäßig 3 und kann vom Benutzer für jede App in den Systemeinstellungen für Benachrichtigungen konfiguriert werden).

Wenn Sie auf die Kopfzeile klicken, genau wie beim Klicken auf den App-Titel, werden keine Benachrichtigungen gelöscht, die zu diesem Header gehören (Ihre App sollte die Popup-APIs verwenden, um die relevanten Benachrichtigungen zu löschen).