Dela via

Toast headers

Du kan visuellt gruppera en uppsättning relaterade meddelanden i Åtgärdscentret genom att använda en aviseringsrubrik på dina meddelanden.

Important

Kräver Desktop Creators Update och 1.4.0 av meddelandebiblioteket: Du måste köra Desktop-version 15063 eller senare för att kunna se toast-huvuden. Du måste använda version 1.4.0 eller senare av UWP Community Toolkit Notifications NuGet-bibliotek för att skapa rubriken i notisens innehåll. Rubriker stöds bara på Desktop.

Som du ser nedan är den här gruppkonversationen enhetlig under en enda rubrik, "Camping!!". Varje enskilt meddelande i konversationen är ett separat toast-meddelande som delar samma toast-rubrik.

rostbröd med rubrik

Du kan också välja att gruppera dina meddelanden visuellt efter kategori också, till exempel flygpåminnelser, paketspårning med mera.

Lägg till en rubrik i en notis-popup

Så här lägger du till en rubrik i ett popup-meddelande.

Note

Rubriker stöds bara på Desktop. Enheter som inte stöder rubriker ignorerar bara rubriken.

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

In summary...

  1. Lägg till Header till din ToastContent
  2. Tilldela de obligatoriska -ID:t, Rubrikoch argument egenskaper
  3. Skicka meddelandet (läs mer)
  4. I ett annat meddelande använder du samma rubrik-ID för att förena dem under rubriken. ID:t är den enda egenskapen som används för att avgöra om meddelandena ska grupperas, vilket innebär att rubrik och argument kan vara olika. Title och Argument från det senaste meddelandet i en grupp används. Om meddelandet tas bort återgår rubrik och argument till nästa senaste meddelande.

Hantera aktivering från en rubrik

Rubriker kan klickas av användare, så att användaren kan klicka på rubriken för att ta reda på mer från din app.

Därför kan appar tillhandahålla Argument i rubriken, precis som startargumenten i själva aviseringen.

Aktiveringen hanteras identiskt med normal toast-aktivering, vilket innebär att du kan hämta dessa argument i metoden OnActivatedApp.xaml.cs på samma sätt som när användaren klickar på toastens brödtext eller en knapp på toasten.

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

Additional info

Rubriken separerar visuellt och grupperar meddelanden. Det ändrar inte någon annan logistik om det maximala antalet meddelanden som en app kan ha (20) och det första in-först-ut-beteendet i meddelandelistan.

Ordningen på meddelanden i rubrikerna är följande... För en viss app visas det senaste meddelandet från appen (och hela rubrikgruppen om en del av ett huvud) först.

Det ID:t kan vara vilken sträng du vill. Det finns inga längd- eller teckenbegränsningar för någon av egenskaperna i ToastHeader. Den enda begränsningen är att hela xml-popup-innehållet inte får vara större än 5 kB.

När du skapar rubriker ändras inte antalet meddelanden som visas i Åtgärdscenter innan knappen "Visa mer" visas (det här talet är 3 som standard och kan konfigureras av användaren för varje app i systeminställningar för meddelanden).

Om du klickar på rubriken, precis som när du klickar på titeln i appen, rensas inga meddelanden kopplade till denna rubrik (appen bör använda toast-API:erna för att rensa relevanta meddelanden).