Comment s’abonner aux notifications toast (applications Windows Runtime)

Article
12/11/2015

[ Cet article est destiné aux développeurs de Windows 8.x et Windows Phone 8.x qui créent des applications Windows Runtime. Si vous développez une application pour Windows 10, voir la Documentation ]

Remarque Vous n’utilisez pas JavaScript ? Voir Comment s’abonner aux notifications toast (XAML).

Cette rubrique explique comment spécifier que votre application est capable de déclencher des notifications toast.

Ce que vous devez savoir

Technologies

Windows Runtime

Prérequis

Conditions préalables à la compréhension de cette rubrique :

Bonnes connaissances des termes et des concepts liés aux notifications toast. Pour plus d’informations, voir Vue d’ensemble des notifications toast.
Bonne connaissance du schéma XML des notifications toast et connaissance générale du langage XML et de sa manipulation via les API DOM (Document Object Model). Pour plus d’informations, voir Schéma des notifications toast.

Instructions

Étape 1: Déclarer la fonctionnalité de notification toast

La fonction de déclenchement de notifications toast est déclarée dans le fichier package.appxmanifest de votre application. Si vous utilisez l’éditeur de manifeste de Microsoft Visual Studio, affectez la valeur « Oui » à l’option Compatible toast, dans la section Notifications de l’onglet Application.

L’exemple suivant illustre le code XML qui est inséré dans le fichier package.appxmanifest à la suite de ce choix d’option. L’attribut ToastCapable est ajouté à l’élément VisualElements du manifeste.

Cet exemple montre également ce que vous devez ajouter si vous créez manuellement le fichier package.appxmanifest en dehors de Visual Studio. Pour plus d’informations, voir Comment créer un manifeste de package manuellement. Notez que si l’option définie dans Visual Studio a la valeur « Oui », ce qui est écrit dans le fichier package.appxmanifest a la valeur « true ».


<VisualElements 
    ...
    ToastCapable="true">
</VisualElements>

Étape 2: Déclarer une couleur d’arrière-plan et de texte pour vos notifications toast (Windows uniquement)

Vous pouvez déclarer une couleur d’arrière-plan et de texte clair ou foncé pour votre notification toast. Notez que ce réglage s’applique aussi à vos vignettes —les couleurs d’arrière-plan et de texte de vos notifications toast et par vignette sont toujours associées.

Si vous utilisez l’éditeur de manifeste de Visual Studio, sélectionnez l’option Texte de premier plan sous l’onglet Composants visuels. Affectez à l’option Couleur d’arrière-plan une chaîne de couleur W3DC (par exemple « #FFFFFF »).

Remarque Les applications du Windows Phone Store ne vous autorisent pas à définir une couleur de texte ou d’arrière-plan. La couleur d’arrière-plan du toast est la couleur d’accentuation système, qui peut être choisie par l’utilisateur dans Paramètres, et le texte est toujours clair.

L’exemple suivant illustre le code XML qui est inséré dans le fichier package.appxmanifest à la suite de ces choix. Les attributs ForegroundText et BackgroundColor sont ajoutés à l’élément VisualElements du manifeste.


<VisualElements 
    ...
    ForegroundText="dark" 
    BackgroundColor="#FFFFFF">
</VisualElements>

Étape 3: Spécifier une image de logo

L’image du petit logo est affichée dans l’angle inférieur droit de chaque notification toast, afin d’indiquer à l’utilisateur quelle application l’a déclenchée.

Remarque Windows Phone 8.1 n’utilise pas cette image de logo. La vignette indique seulement le nom complet de l’application (tel que spécifié dans le manifeste) ou rien du tout.

Si vous utilisez l’éditeur de manifeste de Visual Studio, définissez le chemin d’accès de l’image Logo carré 30 x 30 (Windows) or Logo carré 44 x 44 (Windows Phone) sous l’onglet Composants visuels. L’image spécifiée doit être incluse dans le package de l’application.

L’exemple suivant illustre le code XML qui est inséré dans le fichier package.appxmanifest à la suite de ces choix. L’attribut SmallLogo est ajouté à l’élément VisualElements du manifeste.


<VisualElements 
    ...
    SmallLogo="images\smallTile-sdk.png">
</VisualElements>

Remarques

Une fois que vous avez accompli les étapes ci-dessus, votre application peut envoyer les notifications toast à l’utilisateur.

Terminer l’exemple

L’exemple suivant montre le code XML complet de l’élément VisualElements d’un exemple d’application Windows dans son fichier package.appxmanifest, notamment les attributs abordés dans cette rubrique.


<VisualElements 
    DisplayName="ToastsSample" 
    Logo="images\squareTile-sdk.png" 
    SmallLogo="images\smallTile-sdk.png" 
    Description="SDK Sample" 
    ForegroundText="dark" 
    BackgroundColor="#FFFFFF" 
    ToastCapable="true">
    <DefaultTile ShortName="ToastsSample" ShowName="allLogos"/>
    <SplashScreen BackgroundColor="white" Image="images\splash-sdk.png"/>
</VisualElements>