App-meldingsheaders

U kunt een set gerelateerde meldingen visueel groeperen in het Meldingencentrum door een koptekst toe te voegen aan uw meldingen.

In het onderstaande voorbeeld wordt dit groepsgesprek gecombineerd onder één koptekst, 'Camping!!'. Elk afzonderlijk bericht in het gesprek is een afzonderlijke app-melding die dezelfde koptekst deelt.

U kunt uw meldingen ook visueel groeperen op categorie, zoals vluchtherinneringen, pakkettracking en meer.

Zie het overzicht van app-meldingen voor meer informatie over app-meldingen.

Een koptekst toevoegen aan een melding

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);

Als u meerdere meldingen onder dezelfde koptekst wilt groeperen, gebruikt u dezelfde header-id voor elke melding. De id is de enige eigenschap die wordt gebruikt om groepering te bepalen. De titel en argumenten kunnen verschillen tussen meldingen. De waarden uit de meest recente melding in de groep worden weergegeven. Als deze melding wordt verwijderd, vallen de waarden terug op de volgende meest recente melding.

Activering van een header afhandelen

Kopteksten zijn klikbaar. De eigenschap Argumenten in de koptekst geeft aan welke context aan uw app moet worden doorgegeven wanneer de gebruiker op de koptekst klikt, vergelijkbaar met het starten van argumenten voor de melding zelf.

Activering van een header wordt verwerkt via de notificationInvoked-gebeurtenis , hetzelfde als elke andere activering van meldingen. Zie de App-meldingen quickstart voor meer informatie over het configureren van activering.

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

Aanvullende details

• Kopteksten scheiden en groeperen meldingen visueel, maar ze veranderen niet het maximale aantal meldingen dat een app kan hebben (20) of het first-in-first-out gedrag van de meldingenlijst.
• De id kan elke tekenreeks zijn. Er zijn geen lengte- of tekenbeperkingen voor de headereigenschappen. De enige beperking is dat de volledige inhoud van xml-meldingen niet groter mag zijn dan 5 kB.
• Als u kopteksten maakt, wordt het aantal meldingen dat wordt weergegeven in het Meldingencentrum niet gewijzigd voordat de knop Meer weergeven wordt weergegeven (standaard 3, configureerbaar door de gebruiker in de systeemmeldingsinstellingen).
• Als u op een koptekst klikt, worden de meldingen van die koptekst niet gewist. Uw app moet de meldings-API's gebruiken om de relevante meldingen te wissen.

Zie ook

• Overzicht van app-meldingen