AppNotificationBuilder.AddProgressBar(AppNotificationProgressBar) Méthode

Référence

Définition

Espace de noms:: Microsoft.Windows.AppNotifications.Builder

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.

Modifier

Ajoute une barre de progression à la charge utile XML d’une notification d’application.

public:
 virtual AppNotificationBuilder ^ AddProgressBar(AppNotificationProgressBar ^ value) = AddProgressBar;

AppNotificationBuilder AddProgressBar(AppNotificationProgressBar const& value);

public AppNotificationBuilder AddProgressBar(AppNotificationProgressBar value);

function addProgressBar(value)

Public Function AddProgressBar (value As AppNotificationProgressBar) As AppNotificationBuilder

Paramètres

value: AppNotificationProgressBar

Une AppNotificationProgressBar représentant la barre de progression à ajouter à la notification.

Retours

AppNotificationBuilder

Retourne l’instance AppNotificationBuilder afin que des appels de méthode supplémentaires puissent être chaînés.

Exemples

L’exemple suivant illustre l’ajout d’une zone de liste déroulante à une notification d’application.

var builder = new AppNotificationBuilder()
        .AddText("Downloading this week's new music...")
        .AddProgressBar(new AppNotificationProgressBar()
            .BindTitle()
            .BindValueStringOverride());

    var data = new AppNotificationProgressData(1 /* Sequence number */);
    data.Title = "Artist Name"; // Binds to {progressTitle} in xml payload
    data.Value = 0.5; // Binds to {progressValue} in xml payload
    data.ValueStringOverride = "1/2 songs"; // Binds to {progressValueString} in xml payload
    data.Status = "Downloading..."; // Binds to {progressStatus} in xml payload

    var notification = builder.BuildNotification();
    notification.Progress = data;

    AppNotificationManager.Default.Show(notification);

Charge utile XML résultante :

<toast>
    <visual>
        <binding template='ToastGeneric'>
            <text>Downloading this week&apos;s new music...</text>
            <progress title='{progressTitle}' status='{progressStatus}' value='{progressValue}' valueStringOverride='{progressValueString}'/>
        </binding>
    </visual>
</toast>

Remarques

Liez les champs d’un AppNotificationProgressData pour définir les valeurs initiales et mettre à jour l’état de la barre de progression. Pour plus d’informations sur la liaison de données à une barre de progression dans une notification d’application, consultez barre de progression des notifications d’application et la liaison de données.

Pour obtenir des conseils sur l’utilisation des API AppNotificationBuilder pour créer l’interface utilisateur pour les notifications d’application, consultez contenu de notification d’application.

Pour plus d’informations sur le schéma XML pour les notifications d’application, consultez schéma de contenu de notification d’application.

S’applique à

Partager via