Langage: HTML | XAML

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

Applies to Windows and Windows Phone

Remarque  Vous n'utilisez pas C#/VB/C++ ? Voir Comment s’abonner aux notifications toast (applications du Windows Store en JavaScript et HTML).

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

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.

  • Applies to Windows Phone

Windows Phone ne vous autorise 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.

Affectez à l’option Couleur d’arrière-plan une chaîne de couleur W3DC (par exemple « #FFFFFF »).

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 de petit logo de l’application est affichée dans l’angle inférieur droit de chaque notification toast pour signaler à l’utilisateur l’application qui l’a déclenchée. each toast notification, to identify to the user which app has raised it.

  • Applies to Windows Phone

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.

Exemple complet

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>

Rubriques associées

Vue d’ensemble des notifications toast
Recommandations et liste de vérification sur les notifications toast
Exemple de notifications toast

 

 

Afficher:
© 2015 Microsoft