AppNotificationBuilder.AddText Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Surcharges
AddText(String) |
Ajoute un bloc de texte à la charge utile XML pour une notification d’application. |
AddText(String, AppNotificationTextProperties) |
Ajoute un bloc de texte, avec des options d’affichage et de localisation, à la charge utile XML pour une notification d’application. |
AddText(String)
Ajoute un bloc de texte à la charge utile XML pour une notification d’application.
public:
virtual AppNotificationBuilder ^ AddText(Platform::String ^ text) = AddText;
/// [Windows.Foundation.Metadata.Overload("AddText")]
AppNotificationBuilder AddText(winrt::hstring const& text);
[Windows.Foundation.Metadata.Overload("AddText")]
public AppNotificationBuilder AddText(string text);
function addText(text)
Public Function AddText (text As String) As AppNotificationBuilder
Paramètres
- text
-
String
Platform::String
winrt::hstring
Chaîne contenant le texte à afficher sur la notification d’application.
Retours
Retourne le instance AppNotificationBuilder afin que des appels de méthode supplémentaires puissent être chaînés.
- Attributs
Exemples
L’exemple suivant montre comment ajouter un bloc de texte à la charge utile XML pour une notification d’application.
var notification = new AppNotificationBuilder()
.AddText("Notification text.")
.BuildNotification();
AppNotificationManager.Default.Show(notification);
Charge utile XML résultante :
<toast>
<visual>
<binding template='ToastGeneric'>
<text>Notification text.</text>
</binding>
</visual>
</toast>
Remarques
Un maximum de trois éléments de texte peuvent être ajoutés à une notification d’application. Le dépassement de cette limite génère une erreur.
Pour obtenir des conseils sur l’utilisation des API AppNotificationBuilder pour créer l’interface utilisateur pour les notifications d’application, consultez Contenu des notifications d’application.
Pour obtenir des informations de référence sur le schéma XML pour les notifications d’application, consultez Schéma de contenu de notification d’application.
S’applique à
AddText(String, AppNotificationTextProperties)
Ajoute un bloc de texte, avec des options d’affichage et de localisation, à la charge utile XML pour une notification d’application.
public:
virtual AppNotificationBuilder ^ AddText(Platform::String ^ text, AppNotificationTextProperties ^ properties) = AddText;
/// [Windows.Foundation.Metadata.Overload("AddText2")]
AppNotificationBuilder AddText(winrt::hstring const& text, AppNotificationTextProperties const& properties);
[Windows.Foundation.Metadata.Overload("AddText2")]
public AppNotificationBuilder AddText(string text, AppNotificationTextProperties properties);
function addText(text, properties)
Public Function AddText (text As String, properties As AppNotificationTextProperties) As AppNotificationBuilder
Paramètres
- text
-
String
Platform::String
winrt::hstring
Chaîne contenant le texte à afficher sur la notification d’application.
- properties
- AppNotificationTextProperties
AppNotificationTextProperties spécifiant les propriétés d’affichage et de localisation du texte.
Retours
Retourne le instance AppNotificationBuilder afin que des appels de méthode supplémentaires puissent être chaînés.
- Attributs
Exemples
L’exemple suivant montre comment ajouter un bloc de texte à la charge utile XML pour une notification d’application.
var notification = new AppNotificationBuilder()
.AddText("Notification text.", new AppNotificationTextProperties().SetMaxLines(2))
.BuildNotification();
AppNotificationManager.Default.Show(notification);
Charge utile XML résultante :
<toast>
<visual>
<binding template='ToastGeneric'>
<text hint-maxLines='2'>Notification text.</text>
</binding>
</visual>
</toast>
Remarques
Un maximum de trois éléments de texte peuvent être ajoutés à une notification d’application. Le dépassement de cette limite génère une erreur.
Pour obtenir des conseils sur l’utilisation des API AppNotificationBuilder pour créer l’interface utilisateur pour les notifications d’application, consultez Contenu des notifications d’application.
Pour obtenir des informations de référence sur le schéma XML pour les notifications d’application, consultez Schéma de contenu de notification d’application.