Popupheader

  • Artikel

Sie können einen Satz 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 Den Desktop-Build 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. Header werden nur auf Desktop unterstützt.

Wie unten gezeigt, wird diese Gruppenunterhaltung unter einem einzigen Header", "Camping!!", vereint. Jede einzelne Nachricht in der Unterhaltung ist eine separate Popupbenachrichtigung, die denselben Popupheader teilt.

Popups mit Header

Sie können Ihre Benachrichtigungen auch visuell nach Kategorie gruppieren, z. B. Flugerinnerungen, Paketverfolgung und mehr.

Hinzufügen eines Headers zu einem Popup

Hier erfahren Sie, wie Sie einer Popupbenachrichtigung einen Header hinzufügen.

Hinweis

Header 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?");

Zusammenfassend...

  1. Hinzufügen des Headers zu ToastContent
  2. Zuweisen der erforderlichen Id-, Title- und Arguments-Eigenschaften
  3. Senden Ihrer Benachrichtigung (weitere Informationen)
  4. Verwenden Sie in einer anderen Benachrichtigung dieselbe Header-ID , um sie unter dem Header 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, werden Titel und Argumente auf die nächste neueste Benachrichtigung zurückfallen.

Behandeln der Aktivierung über einen Header

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

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

Die Aktivierung wird mit der normalen Popupaktivierung identisch behandelt. Das bedeutet, dass Sie diese Argumente in der OnActivated-MethodeApp.xaml.cs abrufen können, wie Sie es tun, wenn der Benutzer auf den Text ihres Popups oder auf eine Schaltfläche auf Das 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

Der Header trennt und gruppiert Benachrichtigungen visuell. Es ändert keine andere Logistik hinsichtlich der maximalen Anzahl von Benachrichtigungen, die eine App haben kann (20) und das Verhalten der Benachrichtigungsliste.

Die Reihenfolge der Benachrichtigungen innerhalb von Headern ist wie folgt: Für eine bestimmte App wird zuerst die neueste Benachrichtigung der App (und die gesamte Headergruppe, falls Teil eines Headers) angezeigt.

Die ID kann eine beliebige Zeichenfolge sein, die Sie auswählen. Es gibt keine Längen- oder Zeicheneinschrä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 darf.

Das Erstellen von Headern ändert nicht die Anzahl der Benachrichtigungen, die im Info-Center angezeigt werden, 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).

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