En-têtes de notification d’application

Vous pouvez regrouper visuellement un ensemble de notifications associées dans le Centre de notifications en ajoutant un en-tête à vos notifications.

Dans l’exemple ci-dessous, cette conversation de groupe est unifiée sous un seul en-tête , « Camping !! ». Chaque message individuel dans la conversation est une notification d’application distincte partageant le même en-tête.

Vous pouvez également regrouper visuellement vos notifications par catégorie, comme les rappels de vol, le suivi des colis, etc.

Pour plus d’informations sur les notifications d’application, consultez vue d’ensemble des notifications d’application.

Ajouter un en-tête à une notification

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

Pour regrouper plusieurs notifications sous le même en-tête, utilisez le même ID d’en-tête sur chaque notification. L’ID est la seule propriété utilisée pour déterminer le regroupement , le titre et les arguments peuvent différer entre les notifications. Les valeurs de la notification la plus récente dans le groupe sont affichées. Si cette notification est supprimée, les valeurs reviennent à la prochaine notification la plus récente.

Gérer l’activation à partir d’un en-tête

Les en-têtes sont cliquables. La propriété Arguments de l’en-tête spécifie le contexte à transmettre à votre application lorsque l’utilisateur clique sur l’en-tête, comme pour lancer des arguments sur la notification elle-même.

L’activation à partir d’un en-tête est gérée via l’événement NotificationInvoked , identique à toute autre activation de notification. Pour plus d’informations sur la configuration de l’activation, consultez le guide de démarrage rapide des notifications d’application.

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

Informations supplémentaires

• Les en-têtes séparent visuellement et regroupent les notifications, mais ne modifient pas le nombre maximal de notifications qu’une application peut avoir (20) ou le comportement de premier entré en premier sorti de la liste des notifications.
• L’ID peut être n’importe quelle chaîne. Il n’existe aucune restriction de longueur ou de caractère sur les propriétés d’en-tête. La seule contrainte est que le contenu de notification XML entier ne peut pas dépasser 5 Ko.
• La création d’en-têtes ne modifie pas le nombre de notifications affichées dans le Centre de notification avant que le bouton « Voir plus » s’affiche (3 par défaut, configurable par l’utilisateur dans les paramètres de notification système).
• Cliquer sur un en-tête ne efface pas les notifications appartenant à cet en-tête. Votre application doit utiliser les API de notification pour effacer les notifications pertinentes.

Voir également

• Vue d’ensemble des notifications d’application