Partager via

Toast headers

Vous pouvez regrouper visuellement un ensemble de notifications associées dans le Centre de notifications à l’aide d’un en-tête toast sur vos notifications.

Important

Nécessite la mise à jour Desktop Creators et la bibliothèque des notifications 1.4.0: Vous devez exécuter Desktop build 15063 ou une version ultérieure pour afficher les en-têtes de notification 'toast'. Vous devez utiliser la version 1.4.0 ou ultérieure de la bibliothèque NuGet des notifications UWP Community Toolkit pour construire l’en-tête dans le contenu de votre toast. Les en-têtes sont uniquement pris en charge sur ordinateur de bureau.

Comme indiqué ci-dessous, cette conversation de groupe est unifiée sous un seul en-tête, « Camping !! ». Chaque message individuel de la conversation est une notification de type toast distincte partageant le même en-tête de type toast.

toasts d’en-tête avec

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

Ajouter un en-tête à un toast

Voici comment ajouter un en-tête à une notification toast.

Note

Les en-têtes sont uniquement pris en charge sur ordinateur de bureau. Les appareils qui ne prennent pas en charge les en-têtes ignorent simplement l’en-tête.

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

In summary...

  1. Ajoutez l'en-tête à votre ToastContent
  2. Affectez les propriétés requises : Id, Titre, et Arguments
  3. Envoyer votre notification (en savoir plus)
  4. Sur une autre notification, utilisez le même en-tête identifiant afin de les regrouper sous cet en-tête. L’ID est la seule propriété utilisée pour déterminer si les notifications doivent être regroupées, ce qui signifie que le titre et les arguments peuvent être différents. Le titre et les arguments de la notification la plus récente au sein d’un groupe sont utilisés. Si cette notification est supprimée, alors le Titre et les Arguments reviennent à la notification suivante la plus récente.

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

Les en-têtes sont cliquables par les utilisateurs, afin que l’utilisateur puisse cliquer sur l’en-tête pour en savoir plus à partir de votre application.

Par conséquent, les applications peuvent fournir des Arguments dans l’en-tête, comme les arguments de lancement sur le toast lui-même.

L’activation est gérée de manière identique à d’activation toast normale, ce qui signifie que vous pouvez récupérer ces arguments dans la méthode OnActivated de App.xaml.cs comme vous le faites lorsque l’utilisateur clique sur le corps de votre toast ou sur un bouton sur votre toast.

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

L’en-tête sépare visuellement et regroupe les notifications. Elle ne modifie aucune autre logistique concernant le nombre maximal de notifications qu’une application peut avoir (20) et le comportement de premier entré en premier sorti de la liste des notifications.

L’ordre des notifications dans les en-têtes est le suivant... Pour une application donnée, la notification la plus récente de l’application (et l’ensemble du groupe d’en-têtes si une partie d’un en-tête) apparaît en premier.

L’id peut être n’importe quelle chaîne que vous choisissez. Il n’existe aucune restriction de longueur ou de caractère sur l’une des propriétés de ToastHeader. La seule contrainte est que votre contenu toast XML entier ne peut pas être supérieur à 5 Ko.

La création d’en-têtes ne modifie pas le nombre de notifications affichées dans le Centre de notifications avant que le bouton « Voir plus » s’affiche (ce nombre est 3 par défaut et peut être configuré par l’utilisateur pour chaque application dans paramètres système pour les notifications).

Cliquer sur l’en-tête, tout comme cliquer sur le titre de l’application, ne efface aucune notification appartenant à cet en-tête (votre application doit utiliser les API toast pour effacer les notifications pertinentes).

  • Last updated on