Appmeddelanderubriker

Du kan visuellt gruppera en uppsättning relaterade meddelanden i Meddelandecenter genom att lägga till en rubrik i dina meddelanden.

I exemplet nedan är den här gruppkonversationen enhetlig under en enda rubrik, "Camping!!". Varje enskilt meddelande i konversationen är en separat appavisering som delar samma rubrik.

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

Mer information om appaviseringar finns i Översikt över appaviseringar.

Lägga till en rubrik i ett meddelande

using Microsoft.Windows.AppNotifications;

string xml = @"
<toast>
    <header id='6289' title='Camping!!' arguments='action=openConversation&amp;id=6289'/>
    <visual>
        <binding template='ToastGeneric'>
            <text>Anyone have a sleeping bag I can borrow?</text>
        </binding>
    </visual>
</toast>";

var notification = new AppNotification(xml);
AppNotificationManager.Default.Show(notification);

Om du vill gruppera flera meddelanden under samma rubrik använder du samma rubrik-ID för varje meddelande. ID:t är den enda egenskapen som används för att fastställa gruppering – rubrik och argument kan skilja sig mellan meddelanden. Värdena från det senaste meddelandet i gruppen visas. Om meddelandet tas bort återgår värdena till nästa senaste meddelande.

Hantera aktivering från en rubrik

Rubriker kan klickas. Egenskapen Arguments i rubriken anger vilken kontext som ska skickas till din app när användaren klickar på rubriken, liknande startparametrar i själva meddelandet.

Aktivering från en rubrik hanteras via notificationInvoked-händelsen , samma som andra meddelandeaktivering. Mer information om hur du konfigurerar aktivering finns i Snabbstart för appaviseringar.

AppNotificationManager.Default.NotificationInvoked += (sender, args) =>
{
    // For the header defined above, args.Argument contains:
    // "action=openConversation&id=6289"
    string arguments = args.Argument;
};

Ytterligare detaljer

• Sidhuvuden separerar visuellt och grupperar aviseringar men ändrar inte det maximala antalet aviseringar som en app kan ha (20) eller först-in-först-ut-beteendet hos aviseringslistan.
• ID:t kan vara vilken sträng som helst. Det finns inga längd- eller teckenbegränsningar för rubrikegenskaperna. Den enda begränsningen är att hela XML-meddelandeinnehållet inte får överstiga 5 KB.
• När du skapar rubriker ändras inte antalet meddelanden som visas i Meddelandecenter innan knappen "Visa mer" visas (3 som standard kan konfigureras av användaren i systemaviseringsinställningarna).
• Om du klickar på en rubrik rensas inte meddelandena som hör till rubriken. Din app bör använda meddelande-API:erna för att rensa relevanta meddelanden.

Se även

• Översikt över appaviseringar