Contenu des toastsToast content

Les notifications Toast adaptatives et interactives vous permettent de créer des notifications flexibles avec du texte, des images et des boutons/entrées.Adaptive and interactive toast notifications let you create flexible notifications with text, images, and buttons/inputs.

API importantes  : Package NuGet UWP Community Toolkit NotificationsImportant APIs : UWP Community Toolkit Notifications nuget package

Notes

Pour afficher les modèles hérités de Windows 8.1 et Windows Phone 8,1, consultez le catalogue de modèles Toast hérité.To see the legacy templates from Windows 8.1 and Windows Phone 8.1, see the legacy toast template catalog.

Prise en mainGetting started

Installez la bibliothèque Notifications.Install Notifications library. Si vous préférez utiliser C# plutôt que XML pour générer les notifications, installez le package NuGet Microsoft.Toolkit.Uwp.Notifications (recherchez « notifications uwp ».If you'd like to use C# instead of XML to generate notifications, install the NuGet package named Microsoft.Toolkit.Uwp.Notifications (search for "notifications uwp"). Les exemples de code C# indiqués dans cet article utilisent la version 1.0.0 du package NuGet.The C# samples provided in this article use version 1.0.0 of the NuGet package.

Installez Notifications Visualizer.Install Notifications Visualizer. Cette application Windows gratuite vous aide à concevoir des notifications de Toast interactives en fournissant un aperçu visuel instantané de votre toast quand vous le modifiez, à l’instar de l’éditeur XAML/mode Design de Visual Studio.This free Windows app helps you design interactive toast notifications by providing an instant visual preview of your toast as you edit it, similar to Visual Studio's XAML editor/design view. Consultez le visualiseur de notifications pour plus d’informations ou Téléchargez le visualiseur de notifications à partir du Store.See Notifications Visualizer for more information, or download Notifications Visualizer from the Store.

Envoi d’une notification ToastSending a toast notification

Pour savoir comment envoyer une notification, consultez Envoyer un toast local.To learn how to send a notification, see Send local toast. Cette documentation traite uniquement de la création du contenu Toast.This documentation only covers creating the toast content.

Structure de notification toastToast notification structure

Les notifications Toast sont une combinaison de certaines propriétés de données telles que la balise/le groupe (qui vous permettent d’identifier la notification) et le contenu du Toast .Toast notifications are a combination of some data properties like Tag/Group (which let you identify the notification) and the toast content .

Les principaux composants du contenu Toast sont...The core components of toast content are...

  • Launch : définit les arguments qui seront retransmis à votre application quand l’utilisateur clique sur votre toast, ce qui vous permet d’établir un lien vers le contenu correct affiché par le Toast.launch : This defines what arguments will be passed back to your app when the user clicks your toast, allowing you to deep link into the correct content that the toast was displaying. Pour plus d’informations, consultez Envoyer un toast local.To learn more, see Send local toast.
  • visuel : partie visuelle du Toast, y compris la liaison générique qui contient le texte et les images.visual : The visual portion of the toast, including the generic binding that contains text and images.
  • actions : partie interactive du Toast, y compris les entrées et les actions.actions : The interactive portion of the toast, including inputs and actions.
  • audio : contrôle le son joué lorsque le toast est présenté à l’utilisateur.audio : Controls the audio played when the toast is shown to the user.

Le contenu Toast est défini dans du code XML brut, mais vous pouvez utiliser notre bibliothèque NuGet pour obtenir un modèle objet C# (ou C++) afin de construire le contenu Toast.The toast content is defined in raw XML, but you can use our NuGet library to get a C# (or C++) object model for constructing the toast content. Cet article documente tout ce qui se passe dans le contenu du Toast.This article documents everything that goes within the toast content.

new ToastContentBuilder()
    .AddToastActivationInfo("app-defined-string", ToastActivationType.Foreground)
    .AddText("Some text")
    .AddButton("Archive", ToastActivationType.Background, "archive")
    .AddAudio(new Uri("ms-appx:///Sound.mp3"));

Voici une représentation visuelle du contenu du Toast :Here is a visual representation of the toast's content:

structure de notification toast

Éléments visuelsVisual

Chaque toast doit spécifier un visuel, où vous devez fournir une liaison Toast générique, qui peut contenir du texte, des images et bien plus encore.Each toast must specify a visual, where you must provide a generic toast binding, which can contain text, images, and more. Ces éléments sont affichés sur différents appareils Windows, y compris les ordinateurs de bureau, les téléphones, les tablettes et les Xbox.These elements will be rendered on various Windows devices, including desktop, phones, tablets, and Xbox.

Pour tous les attributs pris en charge dans la section visuelle et ses éléments enfants, consultez la documentation du schéma.For all attributes supported in the visual section and its child elements, see the schema documentation.

L’identité de votre application sur la notification Toast est transporte via l’icône de votre application.Your app's identity on the toast notification is conveyed via your app icon. Toutefois, si vous utilisez le remplacement du logo de l’application, nous affichons le nom de votre application sous vos lignes de texte.However, if you use the app logo override, we will display your app name beneath your lines of text.

Identité de l’application pour un toast normalApp identity for normal toast Identité de l’application avec appLogoOverrideApp identity with appLogoOverride
notification without appLogoOverride notification with appLogoOverride

Éléments de texteText elements

Chaque toast doit avoir au moins un élément de texte et peut contenir deux éléments de texte supplémentaires, tous de type AdaptiveText.Each toast must have at least one text element, and can contain two additional text elements, all of type AdaptiveText.

Toast with title and description

Depuis la mise à jour anniversaire de Windows 10, vous pouvez contrôler le nombre de lignes de texte affichées à l’aide de la propriété HintMaxLines sur le texte.Since the Windows 10 Anniversary Update, you can control how many lines of text are displayed by using the HintMaxLines property on the text. La valeur par défaut (et maximum) est de 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 ).The default (and maximum) is up to 2 lines of text for the title, and up to 4 lines (combined) for the two additional description elements (the second and third AdaptiveText ).

new ToastContentBuilder()
    .AddText("Adaptive Tiles Meeting", hintMaxLines: 1)
    .AddText("Conf Room 2001 / Building 135")
    .AddText("10:00 AM - 10:30 AM");

Remplacement du logo de l’applicationApp logo override

Par défaut, votre toast affiche le logo de votre application.By default, your toast will display your app's logo. Toutefois, vous pouvez remplacer ce logo par votre propre image ToastGenericAppLogo .However, you can override this logo with your own ToastGenericAppLogo image. Par exemple, s’il s’agit d’une notification d’une personne, nous vous recommandons de remplacer le logo de l’application par une image de cette personne.For example, if this is a notification from a person, we recommend overriding the app logo with a picture of that person.

Toast with app logo override

Vous pouvez utiliser la propriété HintCrop pour modifier le rognage de l’image.You can use the HintCrop property to change the cropping of the image. Par exemple, Circle produit une image entourée d’un cercle.For example, Circle results in a circle-cropped image. Dans le cas contraire, l’image est carré.Otherwise, the image is square. Les dimensions de l’image sont 48 pixels à 100% de mise à l’échelle.Image dimensions are 48x48 pixels at 100% scaling.

new ToastContentBuilder()
    ...
    
    .AddAppLogoOverride(new Uri("https://picsum.photos/48?image=883"), NotificationAppLogoCrop.Circle);

Image de hérosHero image

Nouveauté de la mise à jour anniversaire : les toasts peuvent afficher une image de héros, qui est un ToastGenericHeroImage présenté de manière visible dans la bannière Toast et dans le centre de maintenance.New in Anniversary Update : Toasts can display a hero image, which is a featured ToastGenericHeroImage displayed prominently within the toast banner and while inside Action Center. Les dimensions de l’image sont 364x180 pixels à 100% de mise à l’échelle.Image dimensions are 364x180 pixels at 100% scaling.

Toast with hero image
new ToastContentBuilder()
    ...
    
    .AddHeroImage(new Uri("https://picsum.photos/364/180?image=1043"));

Image InlineInline image

Vous pouvez fournir une image Inline pleine largeur qui s’affiche lorsque vous développez le Toast.You can provide a full-width inline-image that appears when you expand the toast.

Toast with additional image
new ToastContentBuilder()
    ...
    
    .AddInlineImage(new Uri("https://picsum.photos/360/202?image=1043"));

Restrictions de taille d’imageImage size restrictions

Les images que vous utilisez dans votre notification Toast peuvent être source à partir de...The images you use in your toast notification can be sourced from...

  • http://http://
  • ms-appx:///ms-appx:///
  • ms-appdata:///ms-appdata:///

Pour les images Web distantes http et HTTPS, il existe des limites sur la taille de fichier de chaque image individuelle.For http and https remote web images, there are limits on the file size of each individual image. Dans la mise à jour des créateurs de automne (16299), nous avons augmenté la limite à 3 Mo sur les connexions normales et 1 Mo sur les connexions limitées.In the Fall Creators Update (16299), we increased the limit to be 3 MB on normal connections and 1 MB on metered connections. Avant cela, les images étaient toujours limitées à 200 Ko.Before that, images were always limited to 200 KB.

Connexion normaleNormal connection Connexion limitéeMetered connection Avant la mise à jour des créateurs de automneBefore Fall Creators Update
3 Mo3 MB 1 Mo1 MB 200 Ko200 KB

Si une image dépasse la taille du fichier ou ne peut pas être téléchargée, ou expire, l’image est supprimée et le reste de la notification s’affiche.If an image exceeds the file size, or fails to download, or times out, the image will be dropped and the rest of the notification will be displayed.

Texte de l’attributionAttribution text

Nouveauté de la mise à jour anniversaire : Si vous devez référencer la source de votre contenu, vous pouvez utiliser le texte de l’attribution.New in Anniversary Update : If you need to reference the source of your content, you can use attribution text. Ce texte est toujours affiché au bas de votre notification, avec l’identité de votre application ou l’horodateur de la notification.This text is always displayed at the bottom of your notification, along with your app's identity or the notification's timestamp.

Dans les versions antérieures de Windows qui ne prennent pas en charge le texte de l’attribution, le texte sera simplement affiché sous la forme d’un autre élément de texte (en supposant que vous n’avez pas encore le maximum de trois éléments de texte).On older versions of Windows that don't support attribution text, the text will simply be displayed as another text element (assuming you don't already have the maximum of three text elements).

Toast with attribution text
new ToastContentBuilder()
    ...
    
    .AddAttributionText("Via SMS");

Horodateur personnaliséCustom timestamp

Nouveautés de Creators Update : vous pouvez désormais remplacer l’horodateur fourni par le système par votre propre horodateur qui représente avec précision le moment où le message/les informations/le contenu a été généré.New in Creators Update : You can now override the system-provided timestamp with your own timestamp that accurately represents when the message/information/content was generated. Cet horodateur est visible dans le centre de maintenance.This timestamp is visible within Action Center.

Toast with custom timestamp

Pour en savoir plus sur l’utilisation d’un horodateur personnalisé, consultez horodatages personnalisés sur les toasts.To learn more about using a custom timestamp, please see custom timestamps on toasts.

new ToastContentBuilder()
    ...
    
    .AddCustomTimeStamp(new DateTime(2017, 04, 15, 19, 45, 00, DateTimeKind.Utc));

Barre de progressionProgress bar

Nouveautés de Creators Update : vous pouvez fournir une barre de progression sur votre notification toast pour informer l’utilisateur de la progression des opérations telles que les téléchargements.New in Creators Update : You can provide a progress bar on your toast notification to keep the user informed of the progress of operations such as downloads.

Toast with progress bar

Pour en savoir plus sur l’utilisation d’une barre de progression, consultez barre de progression Toast.To learn more about using a progress bar, please see Toast progress bar.

En-têtesHeaders

Nouveautés de Creators Update : vous pouvez regrouper les notifications sous les en-têtes dans le centre de maintenance.New in Creators Update : You can group notifications under headers within Action Center. Par exemple, vous pouvez regrouper des messages 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.For example, you can group messages from a group chat under a header, or group notifications of a common theme under a header, or more.

Toasts with header

Pour en savoir plus sur l’utilisation des en-têtes, consultez en-têtes Toast.To learn more about using headers, please see Toast headers.

Contenu adaptatifAdaptive content

Nouveauté de la mise à jour anniversaire : en plus du contenu indiqué ci-dessus, vous pouvez également afficher du contenu adaptatif supplémentaire qui est visible lorsque le toast est développé.New in Anniversary Update : In addition to the content specified above, you can also display additional adaptive content that is visible when the toast is expanded.

Ce contenu supplémentaire est spécifié à l’aide de Adaptive, qui vous permet d’en savoir plus sur en lisant la documentation sur les vignettes adaptatives.This additional content is specified using Adaptive, which you can learn more about by reading the Adaptive Tiles documentation.

Notez que tout contenu adaptatif doit être contenu dans un AdaptiveGroup.Note that any adaptive content must be contained within an AdaptiveGroup. Dans le cas contraire, il ne sera pas rendu à l’aide de Adaptive.Otherwise it will not be rendered using adaptive.

Colonnes et éléments de texteColumns and text elements

Voici un exemple d’utilisation de colonnes et de certains éléments de texte adaptatif avancés.Here's an example where columns and some advanced adaptive text elements are used. Étant donné que les éléments de texte se trouvent dans un AdaptiveGroup , ils prennent en charge toutes les propriétés de style adaptatif riches.Since the text elements are within an AdaptiveGroup , they support all the rich adaptive styling properties.

Toast with additional text
new ToastContentBuilder()
    ...
    
    .AddVisualChild(new AdaptiveGroup()
    {
        Children =
        {
            new AdaptiveSubgroup()
            {
                Children =
                {
                    new AdaptiveText()
                    {
                        Text = "52 attendees",
                        HintStyle = AdaptiveTextStyle.Base
                    },
                    new AdaptiveText()
                    {
                        Text = "23 minute drive",
                        HintStyle = AdaptiveTextStyle.CaptionSubtle
                    }
                }
            },
            new AdaptiveSubgroup()
            {
                Children =
                {
                    new AdaptiveText()
                    {
                        Text = "1 Microsoft Way",
                        HintStyle = AdaptiveTextStyle.CaptionSubtle,
                        HintAlign = AdaptiveTextAlign.Right
                    },
                    new AdaptiveText()
                    {
                        Text = "Bellevue, WA 98008",
                        HintStyle = AdaptiveTextStyle.CaptionSubtle,
                        HintAlign = AdaptiveTextAlign.Right
                    }
                }
            }
        }
    });

BoutonsButtons

Les boutons rendent votre toast interactif, ce qui permet à l’utilisateur d’effectuer des actions rapides sur votre notification Toast sans interrompre son flux de travail actuel.Buttons make your toast interactive, letting the user take quick actions on your toast notification without interrupting their current workflow. 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.For example, users can reply to a message directly from within a toast, or delete an email without even opening the email app. Les boutons s’affichent dans la partie développée de votre notification.Buttons appear in the expanded portion of your notification.

Pour en savoir plus sur l’implémentation de boutons de bout en bout, consultez Envoyer un toast local.To learn more about implementing buttons end-to-end, see Send local toast.

Les boutons peuvent effectuer les actions suivantes...Buttons can perform the following different actions...

  • Activation de l’application au premier plan, avec un argument qui peut être utilisé pour accéder à une page ou à un contexte spécifique.Activating the app in the foreground, with an argument that can be used to navigate to a specific page/context.
  • Activation de la tâche en arrière-plan de l’application, pour une réponse rapide ou un scénario similaire.Activating the app's background task, for a quick-reply or similar scenario.
  • activation d’une autre application par le biais d’un lancement par protocole ;Activating another app via protocol launch.
  • Exécution d’une action système, telle que la répétition ou la disparition de la notification.Performing a system action, such as snoozing or dismissing the notification.

Notes

Vous pouvez avoir jusqu’à 5 boutons (y compris les éléments de menu contextuel que nous aborderons plus tard).You can only have up to 5 buttons (including context menu items which we discuss later).

notification with actions, example 1
new ToastContentBuilder()
    ...
    
    .AddButton("See more details", ToastActivationType.Foreground, "action=viewdetails&contentId=351")
    .AddButton("Remind me later", ToastActivationType.Background, "action=remindlater&contentId=351");

Boutons avec des icônesButtons with icons

Vous pouvez ajouter des icônes à vos boutons.You can add icons to your buttons. Ces icônes sont des images de 16 pixels transparentes en blanc à 100% de mise à l’échelle, et elles ne doivent pas être incluses dans l’image elle-même.These icons are white transparent 16x16 pixel images at 100% scaling, and should have no padding included in the image itself. Si vous choisissez de fournir des icônes sur une notification Toast, 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.If you choose to provide icons on a toast notification, you must provide icons for ALL of your buttons in the notification, as it transforms the style of your buttons into icon buttons.

Notes

Pour l’accessibilité, veillez à inclure une version blanche de l’icône (une icône noire pour les arrière-plans blancs), de sorte que lorsque l’utilisateur active contraste élevé mode blanc, l’icône est visible.For accessibility, be sure to include a contrast-white version of the icon (a black icon for white backgrounds), so that when the user turns on High Contrast White mode, your icon is visible. En savoir plus sur la page d’accessibilité Toast.Learn more on the toast accessiblity page.

Toast that has buttons with icons
new ToastContentBuilder()
    ...
    
    .AddButton(
        "Dismiss",
        ToastActivationType.Foreground,
        "dismiss", new Uri("Assets/NotificationButtonIcons/Dismiss.png", UriKind.Relative));

Boutons avec activation de mise à jour en attenteButtons with pending update activation

Nouveautés de la mise à jour des créateurs de automne : sur les boutons d’activation en arrière-plan, vous pouvez utiliser un comportement d’activation après activation de PendingUpdate pour créer des interactions à plusieurs étapes dans vos notifications Toast.New in Fall Creators Update : On background activation buttons, you can use an after activation behavior of PendingUpdate to create multi-step interactions in your toast notifications. Quand l’utilisateur clique sur le bouton, votre tâche en arrière-plan est activée et le toast est placé dans un État « mise à jour en attente », où il reste à l’écran jusqu’à ce que votre tâche en arrière-plan remplace le Toast par un nouveau Toast.When the user clicks your button, your background task is activated, and the toast gets placed in a "pending update" state, where it stays on screen till your background task replaces the toast with a new toast.

Pour savoir comment implémenter cela, consultez mise à jour en attente de Toast.To learn how to implement this, see Toast pending update.

Toast avec mise à jour en attente

Actions du menu contextuelContext menu actions

Nouveauté de la mise à jour anniversaire : vous pouvez ajouter des actions de menu contextuel supplémentaires au menu contextuel existant qui apparaît lorsque l’utilisateur clique avec le bouton droit sur votre toast dans le centre de maintenance.New in Anniversary Update : You can add additional context menu actions to the existing context menu that appears when the user right clicks your toast from within Action Center. Notez que ce menu s’affiche uniquement quand l’utilisateur clique avec le bouton droit dans le centre de maintenance.Note that this menu only appears when right clicked from Action Center. Il n’apparaît pas quand vous cliquez avec le bouton droit sur une bannière de message Toast.It does not appear when right clicking a toast popup banner.

Notes

Sur les appareils plus anciens, ces actions de menu contextuel supplémentaires s’affichent simplement comme des boutons normaux sur votre toast.On older devices, these additional context menu actions will simply appear as normal buttons on your toast.

Les actions de menu contextuel supplémentaires que vous ajoutez (telles que « changer d’emplacement ») s’affichent au-dessus des deux entrées système par défaut.The additional context menu actions you add (such as "Change location") appear above the two default system entries.

Toast with context menu

La syntaxe du générateur ne prend pas en charge les actions du menu contextuel. nous vous recommandons donc d’utiliser la syntaxe de l’initialiseur.The builder syntax doesn't support context menu actions, so we recommend using initializer syntax.

ToastContent content = new ToastContent()
{
    ...
 
    Actions = new ToastActionsCustom()
    {
        ContextMenuItems =
        {
            new ToastContextMenuItem("Change location", "action=changeLocation")
        }
    }
};

Notes

Des éléments de menu contextuel supplémentaires contribuent à la limite totale de 5 boutons sur un toast.Additional context menu items contribute to the total limit of 5 buttons on a toast.

L’activation d’éléments de menu contextuel supplémentaires est gérée de la même façon que les boutons Toast.Activation of additional context menu items is handled identical to toast buttons.

EntréesInputs

Les entrées sont spécifiées dans la région actions de la région Toast du Toast, ce qui signifie qu’elles sont visibles uniquement lorsque le toast est développé.Inputs are specified within the Actions region of the toast region of the toast, meaning they are only visible when the toast is expanded.

Zone de texte de réponse rapideQuick reply text box

Pour activer une zone de texte de réponse rapide (par exemple, dans une application de messagerie), ajoutez une entrée de texte et un bouton, puis référencez l’ID du champ d’entrée de texte afin que le bouton s’affiche à côté du champ d’entrée.To enable a quick reply text box (for example, in a messaging app) add a text input and a button, and reference the ID of the text input field so that the button is displayed next to to the input field. L’icône du bouton doit être une image de 32x32 pixels sans remplissage, des pixels blancs définis sur transparent et une échelle de 100%.The icon for the button should be a 32x32 pixel image with no padding, white pixels set to transparent, and 100% scale.

notification with text input and actions
new ToastContentBuilder()
    ...
    
    .AddInputTextBox("tbReply", "Type a reply")

    .AddButton(
        textBoxId: "tbReply", // To place button next to text box, reference text box's id
        content: "Reply",
        activationType: ToastActivationType.Background,
        arguments: "action=reply&convId=9318",
        imageUri: new Uri("Assets/Reply.png", UriKind.Relative));

Entrées avec barre de boutonsInputs with buttons bar

Vous pouvez également avoir une (ou plusieurs) entrées avec des boutons normaux affichés sous les entrées.You also can have one (or many) inputs with normal buttons displayed below the inputs.

notification with text and input actions
new ToastContentBuilder()
    ...
    
    .AddInputTextBox("tbReply", "Type a reply")

    .AddButton("Reply", ToastActivationType.Background, "action=reply&threadId=9218")
    .AddButton("Video call", ToastActivationType.Foreground, "action=videocall&threadId=9218");

Entrée de sélectionSelection input

Outre les zones de texte, vous pouvez également utiliser un menu de sélection.In addition to text boxes, you can also use a selection menu.

notification with selection input and actions
new ToastContentBuilder()
    ...
    
    .AddToastInput(new ToastSelectionBox("time")
    {
        DefaultSelectionBoxItemId = "lunch",
        Items =
        {
            new ToastSelectionBoxItem("breakfast", "Breakfast"),
            new ToastSelectionBoxItem("lunch", "Lunch"),
            new ToastSelectionBoxItem("dinner", "Dinner")
        }
    })

    .AddButton(...)
    .AddButton(...);

Répéter/ignorerSnooze/dismiss

À l’aide d’un menu de sélection et de deux boutons, nous pouvons créer une notification de rappel qui utilise les actions répéter et ignorer du système.Using a selection menu and two buttons, we can create a reminder notification that utilizes the system snooze and dismiss actions. Veillez à définir le scénario sur rappel pour que la notification se comporte comme un rappel.Make sure to set the scenario to Reminder for the notification to behave like a reminder.

reminder notification

Nous allons lier le bouton répéter à l’entrée du menu de sélection à l’aide de la propriété SelectionBoxId du bouton Toast.We link the Snooze button to the selection menu input using the SelectionBoxId property on the toast button.

new ToastContentBuilder()
    .SetToastScenario(ToastScenario.Reminder)
    
    ...
    
    .AddToastInput(new ToastSelectionBox("snoozeTime")
    {
        DefaultSelectionBoxItemId = "15",
        Items =
        {
            new ToastSelectionBoxItem("5", "5 minutes"),
            new ToastSelectionBoxItem("15", "15 minutes"),
            new ToastSelectionBoxItem("60", "1 hour"),
            new ToastSelectionBoxItem("240", "4 hours"),
            new ToastSelectionBoxItem("1440", "1 day")
        }
    })

    .AddButton(new ToastButtonSnooze() { SelectionBoxId = "snoozeTime" })
    .AddButton(new ToastButtonDismiss());

Pour utiliser les actions système répéter et ignorer :To use the system snooze and dismiss actions:

  • Spécifiez un ToastButtonSnooze ou un ToastButtonDismissSpecify a ToastButtonSnooze or ToastButtonDismiss
  • Spécifiez éventuellement une chaîne de contenu personnalisée :Optionally specify a custom content string:
    • Si vous ne fournissez pas de chaîne, nous utiliserons automatiquement les chaînes localisées pour « répéter » et « ignorer ».If you don't provide a string, we'll automatically use localized strings for "Snooze" and "Dismiss".
  • Spécifiez éventuellement le SelectionBoxId :Optionally specify the SelectionBoxId :
    • Si vous ne voulez pas que l’utilisateur sélectionne un intervalle de répétition, mais souhaitez simplement que votre notification se répète une seule fois pendant un intervalle de temps défini par le système (et cohérent dans l’ensemble du système d’exploitation), ne construisez aucun élément <input>.If you don't want the user to select a snooze interval and instead just want your notification to snooze only once for a system-defined time interval (that is consistent across the OS), then don't construct any <input> at all.
    • Si vous voulez fournir des sélections d’intervalle de répétition :If you want to provide snooze interval selections:
      • Spécifier SelectionBoxId dans l’action de répétitionSpecify SelectionBoxId in the snooze action
      • Correspond à l’ID de l’entrée avec le SelectionBoxId de l’action de répétitionMatch the id of the input with the SelectionBoxId of the snooze action
      • Spécifiez la valeur de ToastSelectionBoxItem en tant que nonNegativeInteger qui représente l’intervalle de répétition en minutes.Specify ToastSelectionBoxItem 's value to be a nonNegativeInteger which represents snooze interval in minutes.

AudioAudio

L’audio personnalisé a toujours été pris en charge par mobile et est pris en charge dans la version de bureau 1511 (Build 10586) ou plus récente.Custom audio has always been supported by Mobile, and is supported in Desktop Version 1511 (build 10586) or newer. L’audio personnalisé peut être référencé via les chemins d’accès suivants :Custom audio can be referenced via the following paths:

  • ms-appx:///ms-appx:///
  • ms-appdata:///ms-appdata:///

Vous pouvez également choisir parmi la liste des MS-winsoundevents, qui ont toujours été prises en charge sur les deux plateformes.Alternatively, you can pick from the list of ms-winsoundevents, which have always been supported on both platforms.

new ToastContentBuilder()
    ...
    
    .AddAudio(new Uri("ms-appx:///Assets/NewMessage.mp3"));

Consultez la page schéma audio pour plus d’informations sur l’audio dans les notifications Toast.See the audio schema page for information on audio in toast notifications. Pour savoir comment envoyer un toast à l’aide de l’audio personnalisé, consultez l’article audio personnalisé sur les toasts.To learn how to send a toast using custom audio, see custom audio on toasts.

Alarmes, rappels et appels entrantsAlarms, reminders, and incoming calls

Pour créer des alarmes, des rappels et des notifications d’appels entrants, il vous suffit d’utiliser une notification Toast normale avec une valeur de scénario qui lui est assignée.To create alarms, reminders, and incoming call notifications, you simply use a normal toast notification with a scenario value assigned to it. Le scénario adusts quelques comportements pour créer une expérience utilisateur cohérente et unifiée.The scenario adusts a few behaviors to create a consistent and unified user experience.

Important

Lorsque vous utilisez le rappel ou l’alarme, vous devez fournir au moins un bouton sur votre notification Toast.When using Reminder or Alarm, you must provide at least one button on your toast notification. Dans le cas contraire, le Toast sera traité comme un toast normal.Otherwise, the toast will be treated as a normal toast.

  • Rappel : la notification reste à l’écran jusqu’à ce que l’utilisateur la ignore ou effectue une action.Reminder : The notification will stay on screen until the user dismisses it or takes action. Sur Windows Mobile, le Toast s’affichera également en préversion.On Windows Mobile, the toast will also show pre-expanded. Un rappel sera émis.A reminder sound will be played.
  • Alarme : en plus des comportements de rappel, les alarmes effectuent en outre une boucle audio avec un son d’alarme par défaut.Alarm : In addition to the reminder behaviors, alarms will additionally loop audio with a default alarm sound.
  • IncomingCall : les notifications d’appel entrantes sont affichées en mode plein écran sur les périphériques Windows Mobile.IncomingCall : Incoming call notifications are displayed full screen on Windows Mobile devices. Dans le cas contraire, ils ont les mêmes comportements que les alarmes, sauf qu’ils utilisent l’audio de sonnerie et que leurs boutons ont un style différent.Otherwise, they have the same behaviors as alarms except they use ringtone audio and their buttons are styled differently.
new ToastContentBuilder()
    .SetToastScenario(ToastScenario.Reminder)
    ...

Localisation et accessibilitéLocalization and accessibility

Vos mosaïques et toasts 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.Your tiles and toasts can load strings and images tailored for display language, display scale factor, high contrast, and other runtime contexts. Pour plus d’informations, consultez prise en charge des notifications par vignette et toast pour la langue, la mise à l’échelle et le contraste élevé.For more info, see Tile and toast notification support for language, scale, and high contrast.

Gestion de l’activationHandling activation

Pour savoir comment gérer les activations de Toast (l’utilisateur qui clique sur votre toast ou sur les boutons du Toast), consultez Envoyer un toast local.To learn how to handle toast activations (the user clicking your toast or buttons on the toast), see Send local toast.