AppNotificationBuilder.AddProgressBar(AppNotificationProgressBar) Metodo

Definizione

Spazio dei nomi:

Microsoft.Windows.AppNotifications.Builder

Aggiunge una barra di stato al payload XML per una notifica dell'app.

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

Parametri

value

AppNotificationProgressBar

AppNotificationProgressBar che rappresenta la barra di avanzamento da aggiungere alla notifica.

Restituisce

AppNotificationBuilder

Restituisce l'istanza di AppNotificationBuilder in modo che sia possibile concatenare altre chiamate al metodo.

Esempio

Nell'esempio seguente viene illustrata l'aggiunta di una casella combinata a una notifica dell'app.

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);

Payload XML risultante:

<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>

Commenti

Associare i campi di appNotificationProgressData per impostare i valori iniziali e lo stato aggiornato della barra di stato. Per informazioni sul data binding a una barra di stato in una notifica dell'app, vedere Barra di stato delle notifiche dell'app e data binding.

Per indicazioni sull'uso delle API AppNotificationBuilder per creare l'interfaccia utente per le notifiche dell'app, vedere Contenuto di notifica dell'app.

Per informazioni di riferimento sullo schema XML per le notifiche dell'app, vedere Schema del contenuto di notifica dell'app.