Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Cet article décrit les éléments d’interface utilisateur qui peuvent être utilisés dans une notification d’application et fournit des exemples de code pour générer le contenu de notification. Pour plus d’informations sur les notifications d’application, consultez vue d’ensemble des notifications d’application. Pour obtenir une procédure pas à pas de l’implémentation des notifications d’application, consultez Quickstart : App notifications in the SDK d'application Windows.
Premiers pas
Les notifications d’application sont définies avec une charge utile XML définie par le schéma de notification d’application. Actuellement, il existe deux façons de générer la charge utile XML pour une notification d’application. Les exemples de code de cet article illustrent les deux méthodes :
- Microsoft.Windows. AppNotifications.Builder API - Introduites dans SDK d'application Windows 1.2, cet espace de noms fournit des API qui vous permettent de générer facilement la charge utile XML pour une notification par programmation sans avoir à vous soucier des spécificités du format XML. Les exemples de code utilisant ces API se trouvent dans les onglets intitulés « SDK d'application Windows ».
- XML brut : si vous préférez, vous pouvez créer votre propre code personnalisé pour générer des chaînes XML au format requis. Les exemples XML bruts se trouvent dans les onglets intitulés « XML ».
Installez le visualiseur de notifications. Cette application gratuite Windows vous aide à concevoir des notifications interactives d'application en fournissant un aperçu visuel instantané de votre toast lorsque vous la modifiez, comme l'éditeur/la vue de conception XAML de Visual Studio. Consultez le Visualiseur de Notifications pour plus d’informations ou téléchargez le Visualiseur de Notifications à partir du Magasin.
Cet article traite uniquement de la création du contenu de notification d’application. Pour plus d’informations sur l’envoi d’une notification, consultez la vue d’ensemble des notifications d’application.
Structure de notification d’application
Voici quelques composants importants et généraux d’une charge utile XML de notification d’application :
- toast : l’attribut de lancement de cet élément définit les arguments qui seront transmis à votre application lorsque l’utilisateur clique sur votre toast, ce qui vous permet de lier en profondeur le contenu correct affiché par le toast. Pour en savoir plus, consultez la vue d’ensemble des notifications d’application.
- visuel : cet élément représente une partie visuelle du toast, y compris la liaison générique qui contient du texte et des images.
- actions : cet élément représente une partie interactive du toast, y compris les entrées et les actions.
- audio : cet élément spécifie l’audio lu lorsque le toast est affiché à l’utilisateur.
var builder = new AppNotificationBuilder()
.AddArgument("conversationId", "9813")
.AddText("Some text")
.AddButton(new AppNotificationButton("Archive")
.AddArgument("action", "archive"))
.SetAudioUri(new Uri("ms-appx:///Sound.mp3"));
Voici une représentation visuelle du contenu de la notification d’application :
Zone d’attribution
La zone d’attribution se trouve en haut de la notification de l’application. À partir de Windows 11, le nom et l'icône de votre application s'affichent dans cette zone. La zone d'attribution inclut également un bouton fermer qui permet à l'utilisateur de fermer rapidement la notification et un menu à trois points permettant de désactiver rapidement les notifications pour votre application ou d'accéder directement à la page des paramètres de Windows pour les notifications de votre application. La zone d’attribution est configurée par l’interpréteur de commandes et ne peut pas être remplacée dans la charge utile XML toast, bien que votre application puisse ajouter des éléments au menu contextuel de la zone d’attribution. Pour plus d’informations, consultez les actions du menu contextuel.
Élément visuel
Chaque notification d’application doit spécifier un élément visuel , où vous devez fournir une liaison toast générique et qui peut contenir du texte et des images. Ces éléments seront rendus sur différents appareils Windows, notamment les ordinateurs de bureau, les téléphones, les tablettes et les Xbox.
Pour tous les attributs pris en charge dans la section visuelle et ses éléments enfants, consultez le schéma de notifications d'applications.
Éléments de texte
Chaque notification d’application doit avoir au moins un élément de texte et peut contenir deux éléments de texte supplémentaires, tout type AdaptiveText. Les éléments de texte prennent en charge la liaison de données, ce qui vous permet de mettre à jour le contenu du texte une fois la notification affichée. Pour plus d’informations, consultez la barre de progression des notifications d’application et la liaison de données.
Vous pouvez contrôler le nombre de lignes de texte affichées à l’aide de la méthode AppNotificationTextProperties.SetMaxLines . La valeur par défaut (et maximale) est jusqu’à 2 lignes de texte pour le titre, et jusqu’à 4 lignes (combinées) pour les deux éléments de description supplémentaires (le deuxième et le troisième AdaptiveText).
var builder = new AppNotificationBuilder()
.AddArgument("conversationId", 9813)
.AddText("Adaptive Tiles Meeting", new AppNotificationTextProperties().SetMaxLines(1))
.AddText("Conf Room 2001 / Building 135")
.AddText("10:00 AM - 10:30 AM");
Image en ligne
Par défaut, les images sont affichées inline, après tous les éléments de texte, remplissant la largeur totale de la zone visuelle. Utilisez AppNotificationBuilder.SetInlineImage pour ajouter une image inline.
var builder = new AppNotificationBuilder()
.AddText("Featured image of the day.")
.SetInlineImage(new Uri("ms-appx:///Images/InlineImage.png"));
AppNotificationManager.Default.Show(builder.BuildNotification());
Remplacement du logo de l’application
La spécification d’une valeur de placement « appLogoOverride » entraîne l’affichage de l’image dans un carré situé à gauche de la zone visuelle. Utilisez AppNotificationBuilder.SetAppLogoOverride pour définir cette image. Le nom de cette propriété reflète le comportement dans les versions précédentes de Windows, où l’image remplacerait l’image du logo de l’application par défaut. Dans Windows 11, le logo de l’application s’affiche dans la zone d’attribution. Il n’est donc pas remplacé par le placement d’images appLogoOverride.
Les dimensions de l'image sont de 48x48 pixels à l'échelle 100 %. Nous vous recommandons généralement de fournir une version de chaque ressource d'icône pour chaque facteur d’échelle : 100%, 125%, 150%, 200%, et 400%.
var builder = new AppNotificationBuilder()
.AddText("Featured image of the day.")
.SetAppLogoOverride(new Uri("ms-appx:///Images/AppLogo.png"));
Conseil de découpe
Microsoft instructions de style recommandent de représenter des images de profil avec une image circulaire pour fournir une représentation cohérente des personnes entre les applications et l’interpréteur de commandes. Passez AppNotificationImageCrop.Circle à SetAppLogoOverride pour afficher l’image avec une rognage circulaire.
var builder = new AppNotificationBuilder()
.AddText("Matt sent you a friend request")
.AddText("Hey, wanna dress up as wizards and ride around on hoverboards?")
.SetAppLogoOverride(new Uri("ms-appx:///Images/Profile.png"), AppNotificationImageCrop.Circle);
Image de héros
Les notifications d'application peuvent afficher une image en vedette, qui est un élément toastGenericHeroImage affiché en évidence dans la bannière toast et dans le Centre de notifications. Utilisez AppNotificationBuilder.SetHeroImage pour ajouter une image héros. Les dimensions d’image sont de 364 x 180 pixels à 100% mise à l’échelle.
var builder = new AppNotificationBuilder()
.AddText("Marry Anne")
.AddText("Check out where we camped last night!")
.SetHeroImage(new Uri("ms-appx:///Images/HeroImage.png"));
Restrictions de taille d’image
Les images que vous utilisez dans la notification de votre application peuvent être sources à partir de...
- http://
- ms-appx:///
- ms-appdata :///
Pour les images web http et https distantes, il existe des limites sur la taille de fichier de chaque image individuelle. La limite est de 3 Mo sur les connexions normales et de 1 Mo sur les connexions limitées.
| Connexion normale | Connexion mesurée |
|---|---|
| 3 Mo | 1 Mo |
Si une image dépasse la taille du fichier, ou ne parvient pas à télécharger ou expire, l’image est supprimée et le reste de la notification s’affiche.
Texte d’attribution
Si vous devez référencer la source de votre contenu, vous pouvez utiliser le texte d’attribution. Utilisez AppNotificationBuilder.SetAttributionText pour définir le texte d’attribution. Ce texte est toujours affiché sous tous les éléments de texte, mais au-dessus des images incorporées. Le texte utilise une taille légèrement plus petite que les éléments de texte standard pour faire la distinction entre les éléments de texte standard.
Sur les versions antérieures de Windows qui ne prennent pas en charge le texte d'attribution, le texte s'affiche simplement en tant qu'autre élément de texte (en supposant que vous n'avez pas déjà le maximum de trois éléments de texte).
var builder = new AppNotificationBuilder()
.AddText("Marry Anne")
.AddText("Check out where we camped last night!")
.SetAttributionText("via SMS");
.SetHeroImage(new Uri("ms-appx:///Images/HeroImage.png"));
Horodatage personnalisé
Vous pouvez remplacer l’horodatage fourni par le système par votre propre horodatage qui représente avec précision le moment où le message/information/contenu a été généré. Cet horodatage est visible dans le Centre de notification.
Pour en savoir plus sur l’utilisation d’un horodatage personnalisé, consultez les horodatages personnalisés sur les notifications d’application.
var builder = new AppNotificationBuilder()
.AddText("Matt sent you a friend request")
.AddText("Hey, wanna dress up as wizards and ride around on hoverboards?")
.SetTimeStamp(new DateTime(2017, 04, 15, 19, 45, 00, DateTimeKind.Utc));
Barre de progression
Vous pouvez fournir une barre de progression sur votre notification d’application pour informer l’utilisateur de la progression des opérations telles que les téléchargements. Les barres de progression prennent en charge la liaison de données, ce qui vous permet de mettre à jour dynamiquement les valeurs de progression une fois la notification affichée.
Pour en savoir plus sur l’utilisation d’une barre de progression, consultez la barre de progression des notifications d’application et la liaison de données.
En-têtes
Vous pouvez regrouper les notifications sous les en-têtes dans le Centre de notifications. Par exemple, vous pouvez regrouper des messages à partir d’une conversation de groupe sous un en-tête ou des notifications de groupe d’un thème commun sous un en-tête, ou plus.
Pour en savoir plus sur l’utilisation d’en-têtes, consultez les en-têtes de notification d’application.
Contenu adaptatif
Outre le contenu spécifié ci-dessus, vous pouvez également afficher du contenu adaptatif supplémentaire visible lorsque la notification toast est déroulée.
Ce contenu supplémentaire est spécifié à l’aide de Adaptive, que vous pouvez en savoir plus en lisant la documentation des vignettes adaptatives.
Notez que tout contenu adaptatif doit être contenu dans un adaptiveGroup. Sinon, il ne sera pas rendu de manière adaptative.
Colonnes et éléments de texte
Voici un exemple où les colonnes et certains éléments de texte adaptatif avancés sont utilisés. Étant donné que les éléments de texte se trouvent dans un AdaptiveGroup, ils prennent en charge toutes les propriétés de style adaptative enrichies.
// The Microsoft.Windows.AppNotifications.Builder syntax does not currently support adaptive text elements.
Boutons
Les boutons rendent votre toast interactif, ce qui permet à l’utilisateur d’effectuer des actions rapides sur la notification de votre application sans interrompre son flux de travail actuel. Par exemple, les utilisateurs peuvent répondre à un message directement à partir d’un toast ou supprimer un e-mail sans même ouvrir l’application de messagerie. Les boutons apparaissent dans la partie développée de votre notification. Utilisez AppNotificationButton pour définir des boutons et AppNotificationBuilder.AddButton pour les ajouter à la notification.
Pour en savoir plus sur l’implémentation de boutons de bout en bout, consultez la vue d’ensemble des notifications d’application.
Les boutons peuvent activer une application de la manière suivante :
- L’application est activée au premier plan, avec un argument qui peut être utilisé pour accéder à une page/contexte spécifique.
- Une autre application est activée via le lancement du protocole.
- L’activation en arrière-plan est prise en charge explicitement pour les applications UWP. Pour les applications SDK d'application Windows, l’application est toujours lancée au premier plan. L’application peut appeler AppInstance.GetActivatedEventArgs pour détecter si l’activation a été lancée par une notification et déterminer à partir des arguments passés s’il faut lancer entièrement l’application de premier plan ou gérer simplement la notification et la sortie.
- Les actions système, telles que la mise en veille ou l'abandon de la notification, sont prises en charge à la fois pour les applications UWP et pour le SDK d'application Windows. Les API AppNotificationBuilder ne prennent pas en charge ce scénario, mais SDK d'application Windows applications peuvent implémenter ce scénario à l'aide de la Microsoft.Windows. AppNotifications.Builder API ou XML brut.
Note
Vous ne pouvez avoir que 5 boutons (y compris les éléments de menu contextuel que nous abordons plus tard).
var builder = new AppNotificationBuilder()
.AddText("New product in stock!")
.AddButton(new AppNotificationButton("See more details")
.AddArgument("action", "viewDetails"))
.AddArgument("contentId", "351")
.AddButton(new AppNotificationButton("Remind me later")
.AddArgument("action", "remindLater"))
.AddArgument("contentId", "351");
Boutons avec icônes
Vous pouvez ajouter des icônes à vos boutons à l’aide d’AppNotificationButton.SetIcon. Ces icônes sont des images de 16 x 16 pixels, blanches et transparentes, à échelle 100 %, et ne doivent pas inclure de marge dans l'image elle-même. Si vous choisissez de fournir des icônes sur une notification d’application, vous devez fournir des icônes pour TOUS vos boutons dans la notification, car elle transforme le style de vos boutons en boutons d’icône.
Note
Pour l’accessibilité, veillez à inclure une version de contraste blanc de l’icône (icône noire pour les arrière-plans blancs) afin que lorsque l’utilisateur active le mode Contraste élevé blanc, votre icône est visible. Pour plus d’informations, consultez la prise en charge des notifications vignette et toast pour la langue, la mise à l’échelle et le contraste élevé.
var builder = new AppNotificationBuilder()
.AddText("Return books to the library.")
.AddButton(new AppNotificationButton("Accept")
.AddArgument("action", "accept")
.SetIcon(new Uri("ms-appx:///Images/Accept.png")))
.AddButton(new AppNotificationButton("Snooze")
.AddArgument("action", "snooze")
.SetIcon(new Uri("ms-appx:///Images/Snooze.png")))
.AddButton(new AppNotificationButton("Dismiss")
.AddArgument("action", "dismiss")
.SetIcon(new Uri("ms-appx:///Images/Dismiss.png")));
Nouveautés de la mise à jour de Windows 11 : vous pouvez ajouter des info-bulles à vos icônes avec la propriété HintToolTip dans le XML. Cela est idéal si vos boutons ont des icônes, mais pas de contenu, car cela vous permet de passer du texte que Windows Narrateur peut lire. Toutefois, si le contenu est présent, le Narrateur le lit, peu importe ce qui est passé dans l’info-bulle.
var button = new AppNotificationButton("Reply")
.AddArgument("action", "reply");
if (AppNotificationButton.IsToolTipSupported())
{
button.ToolTip = "Click to reply.";
}
var builder = new AppNotificationBuilder()
.AddText("Notification text.")
.AddButton(button);
Boutons avec des couleurs
New in Windows 11 Update : vous pouvez ajouter des couleurs rouges ou vertes à vos boutons à l’aide de AppNotificationButton.SetButtonStyle avec AppNotificationButtonStyle. Dans XML, ajoutez l’attribut useButtonStyle à l’élément toast et l’attribut hint-buttonStyle à l’élément d’action, comme indiqué ci-dessous.
var builder = new AppNotificationBuilder()
.SetScenario(AppNotificationScenario.IncomingCall)
.AddText("Andrew Bares", new AppNotificationTextProperties()
.SetIncomingCallAlignment())
.AddText("Incoming Call - Mobile", new AppNotificationTextProperties()
.SetIncomingCallAlignment())
.SetInlineImage(new Uri("ms-appx:///Images/Profile.png"),
AppNotificationImageCrop.Circle)
.AddButton(new AppNotificationButton()
.SetToolTip("Answer Video Call")
.SetButtonStyle(AppNotificationButtonStyle.Success)
.SetIcon(new Uri("ms-appx:///Images/Video.png"))
.AddArgument("videoId", "123"))
.AddButton(new AppNotificationButton()
.SetToolTip("Answer Phone Call")
.SetButtonStyle(AppNotificationButtonStyle.Success)
.SetIcon(new Uri("ms-appx:///Images/Call.png"))
.AddArgument("callId", "123"))
.AddButton(new AppNotificationButton()
.SetToolTip("Hang Up")
.SetButtonStyle(AppNotificationButtonStyle.Critical)
.SetIcon(new Uri("ms-appx:///Images/HangUp.png"))
.AddArgument("hangUpId", "123"));
Actions de menu contextuel
Vous pouvez ajouter des actions de menu contextuel supplémentaires au menu contextuel existant qui s’affiche lorsque l’utilisateur clique avec le bouton droit sur votre notification d’application ou sélectionne l’icône du menu contextuel. Utilisez AppNotificationButton.SetContextMenuPlacement pour placer un bouton dans le menu contextuel au lieu de la barre d’actions.
Note
Sur les appareils plus anciens, ces actions de menu contextuel supplémentaires s’affichent simplement sous forme de boutons normaux sur votre notification.
Les actions de menu contextuel supplémentaires que vous ajoutez (par exemple, « Désactiver la conversation de groupe pendant 1 heure ») apparaissent au-dessus des deux entrées système par défaut.
var builder = new AppNotificationBuilder()
.AddText("Camping this weekend?")
.SetAppLogoOverride(new Uri("ms-appx:///images/Reply.png"), AppNotificationImageCrop.Circle)
.AddButton(new AppNotificationButton("Mute group chat for 1 hour")
.AddArgument("action", "mute")
.SetContextMenuPlacement());
Note
Les éléments de menu contextuel supplémentaires contribuent à la limite totale de 5 boutons sur un toast.
L’activation d’éléments de menu contextuel supplémentaires est gérée de manière identique aux boutons toast.
Données d'entrée
Les entrées sont spécifiées dans la région Actions de la notification d’application, ce qui signifie qu’elles ne sont visibles que lorsque la notification est développée.
Zone de texte réponse rapide
Pour activer une zone de texte de réponse rapide (par exemple, dans une application de messagerie), ajoutez une entrée de texte avec AppNotificationBuilder.AddTextBox et un bouton, puis référencez l’ID du champ d’entrée de texte afin que le bouton s’affiche en regard du champ d’entrée. L’icône facultative du bouton, le cas échéant, doit être une image de 32 x 32 pixels sans remplissage, pixels blancs définis sur transparent et 100% échelle.
var builder = new AppNotificationBuilder()
.AddTextBox("textBox", "Type a reply", "Reply")
.AddButton(AppNotificationButton("Send")
.AddArguments("action", "Send")
.SetInputId("textBox"))
.BuildNotification();
Entrées avec barre de boutons
Vous pouvez également avoir une (ou plusieurs) entrées avec des boutons normaux affichés sous les entrées.
// The Microsoft.Windows.AppNotifications.Builder syntax does not currently support quick reply text boxes.
Entrée de sélection
Outre les zones de texte, vous pouvez également utiliser un menu de sélection avec AppNotificationBuilder.AddComboBox.
var builder = new AppNotificationBuilder()
.AddText("4th coffee?")
.AddText("When do you plan to come in tomorrow?")
.AddComboBox(new AppNotificationComboBox("time")
.SetTitle("Select an item:")
.AddItem("breakfast", "Breakfast")
.AddItem("lunch", "Lunch")
.AddItem("dinner", "Dinner")
.SetSelectedItem("lunch"))
.AddButton(new AppNotificationButton("Reply")
.AddArgument("action", "reply")
.AddArgument("threadId", "9218")
.SetContextMenuPlacement())
.AddButton(new AppNotificationButton("Call restaurant")
.AddArgument("action", "videocall")
.AddArgument("threadId", "9218")
.SetContextMenuPlacement());
Répéter/Ignorer
À l’aide d’un menu de sélection et de deux boutons, nous pouvons créer une notification de rappel qui utilise les actions de mise en veille et annulation du système. Veillez à définir le scénario sur « Rappel » pour que la notification se comporte comme un rappel.
Nous lions le bouton Snooze à la saisie du menu de sélection à l'aide de la propriété SelectionBoxId sur le bouton toast.
La syntaxe Microsoft.Windows.AppNotifications.Builder ne supporte pas actuellement l’activation du système. Toutefois, ce scénario est pris en charge pour les applications SDK d'application Windows, et vous pouvez générer des notifications pour ce scénario à l’aide de XML brut.
// The Microsoft.Windows.AppNotifications.Builder syntax does not currently support system activation.
// But this scenario is supported for Windows App SDK apps, and you can build notifications for this
// scenario using raw XML.
Pour utiliser la temporisation et annuler ces actions du système :
- Spécifier un ToastButtonSnooze ou ToastButtonDismiss
- Spécifiez éventuellement une chaîne de contenu personnalisée :
- Si vous ne fournissez pas de chaîne, nous allons utiliser automatiquement des chaînes localisées pour « Snooze » et « Ignorer ».
- Spécifiez éventuellement selectionBoxId :
- Si vous ne souhaitez pas que l’utilisateur sélectionne un intervalle de répétition et que votre notification ne snooze qu’une seule fois pour un intervalle de temps défini par le système (cohérent dans le système d’exploitation), ne construisez <aucune entrée> du tout.
- Si vous souhaitez fournir des sélections d’intervalle snooze : - Spécifiez SelectionBoxId dans l’action snooze - Mettez en correspondance l’ID de l’entrée avec SelectionBoxId de l’action snooze - Spécifiez la valeur de ToastSelectionBoxItem comme un entier non négatif qui représente l’intervalle de répétition en minutes.
Audio
Utilisez AppNotificationBuilder.SetAudioUri pour spécifier un fichier audio personnalisé ou utilisez AppNotificationBuilder.SetAudioEvent pour sélectionner un son système. L’audio personnalisé peut être référencé via les chemins suivants :
- ms-appx:///
- ms-appdata :///
var builder = new AppNotificationBuilder()
.AddText("Notification text.")
.SetAudioUri(new Uri("ms-appx:///Audio/NotificationSound.mp3"));
Vous pouvez également choisir parmi la liste des ms-winsoundevents, qui ont toujours bénéficié d'une prise en charge sur les deux plateformes.
var builder = new AppNotificationBuilder()
.AddText("Notification text.")
.SetAudioEvent(AppNotificationSoundEvent.Alarm, AppNotificationAudioLooping.Loop);
Consultez la page de schéma audio pour plus d’informations sur l’audio dans les notifications d’application. Pour savoir comment envoyer une notification d’application qui utilise un audio personnalisé, consultez l’audio personnalisé sur les notifications d’application.
Scénarios
Pour créer des notifications importantes, des alarmes, des rappels et des notifications d’appel entrantes, utilisez AppNotificationBuilder.SetScenario avec une valeur AppNotificationScenario . Le scénario ajuste quelques comportements pour créer une expérience utilisateur cohérente et unifiée. Il existe quatre valeurs de scénario possibles :
- Reminder
- Alarm
- IncomingCall
- Urgent
Rappels
Dans le scénario de rappel, la notification reste à l’écran jusqu’à ce que l’utilisateur l’ignore ou prenne des mesures. Sur Windows Mobile, la notification de l'application apparaît également déjà pré-développée. Un son de rappel sera joué. Vous devez fournir au moins un bouton sur la notification de votre application. Sinon, la notification sera traitée comme une notification normale.
var builder = new AppNotificationBuilder()
.AddText("Notification text.")
.SetScenario(AppNotificationScenario.Reminder);
Alarmes
Les alarmes se comportent de la même façon que les rappels, sauf que les alarmes répètent automatiquement un son d’alarme par défaut. Vous devez fournir au moins un bouton sur la notification de votre application. Sinon, la notification sera traitée comme une notification normale.
var builder = new AppNotificationBuilder()
.AddText("Notification text.")
.SetScenario(AppNotificationScenario.Alarm)
.AddButton(new AppNotificationButton("Dismiss")
.AddArgument("action", "dismiss"));
Appels entrants
Les notifications d’appel entrantes s’affichent pré-développées dans un format spécial d’appel et restent sur l’écran de l’utilisateur jusqu’à ce qu’elles soient ignorées. L’audio de sonnerie boucle en continu par défaut. Sur les appareils mobiles Windows, ils s'affichent en plein écran.
var builder = new AppNotificationBuilder()
.SetScenario(AppNotificationScenario.IncomingCall)
.AddText("Andrew Bares", new AppNotificationTextProperties()
.SetIncomingCallAlignment())
.AddText("incoming call - mobile", new AppNotificationTextProperties()
.SetIncomingCallAlignment())
.SetInlineImage(new Uri("ms-appx:///images/profile.png"),
AppNotificationImageCrop.Circle)
.AddButton(new AppNotificationButton("Text reply")
.SetToolTip("Text reply")
.SetIcon(new Uri("ms-appx:///images/reply.png"))
.AddArgument("textId", "123"))
.AddButton(new AppNotificationButton("Reminder")
.SetToolTip("Reminder")
.SetIcon(new Uri("ms-appx:///images/reminder.png"))
.AddArgument("reminderId", "123"))
.AddButton(new AppNotificationButton("Ignore")
.SetToolTip("Ignore")
.SetIcon(new Uri("ms-appx:///images/ignore.png"))
.AddArgument("ignoreId", "123"))
.AddButton(new AppNotificationButton("Answer")
.SetToolTip("Answer")
.SetIcon(new Uri("ms-appx:///images/answer.png"))
.AddArgument("answerId", "123"));
Notifications importantes
Important
Requires : vous devez exécuter Windows Insider Preview Build 22546 ou version ultérieure pour utiliser des notifications importantes.
Les notifications importantes permettent aux utilisateurs d’avoir plus de contrôle sur les applications de première et de tierces parties qui peuvent leur envoyer des notifications d'application de haute priorité (urgentes/importantes) pouvant passer par Focus Assist (Ne pas déranger). Cela peut être modifié dans les paramètres de notifications.
var builder = new AppNotificationBuilder()
.AddText("Adaptive Tiles Meeting",
new AppNotificationTextProperties()
.SetMaxLines(1))
.AddText("Conf Room 2001 / Building 135")
.AddText("10:00 AM - 10:30 AM");
if (AppNotificationBuilder.IsUrgentScenarioSupported())
{
builder.SetScenario(AppNotificationScenario.Urgent);
}
Localisation et accessibilité
Vos vignettes et notifications d’application peuvent charger des chaînes et des images adaptées à la langue d’affichage, au facteur d’échelle d’affichage, au contraste élevé et à d’autres contextes d’exécution. Pour plus d’informations, consultez la prise en charge des notifications vignette et toast pour la langue, la mise à l’échelle et le contraste élevé.
Gestion de l’activation
Pour savoir comment gérer les activations d’application (l’utilisateur clique sur votre notification ou vos boutons sur la notification), consultez la vue d’ensemble des notifications d’application.
Rubriques connexes
Collaborer avec nous sur GitHub
La source de ce contenu se trouve sur GitHub, où vous pouvez également créer et examiner les problèmes et les demandes de tirage. Pour plus d’informations, consultez notre guide du contributeur.
Windows developer