AppNotificationBuilder.AddProgressBar(AppNotificationProgressBar) Metodo

Riferimento

Definizione

Spazio dei nomi:: Microsoft.Windows.AppNotifications.Builder

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Modifica

Aggiunge un indicatore 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

Un AppNotificationProgressBar che rappresenta l'indicatore di stato da aggiungere alla notifica.

Restituisce

AppNotificationBuilder

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

Esempio

L'esempio seguente illustra 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 un AppNotificationProgressData per impostare i valori iniziali e lo stato aggiornato della barra di stato. Per informazioni sul data binding a un indicatore di stato in una notifica dell'app, vedere barra di stato della notifica dell'app e data binding.

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

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

Si applica a

Condividi tramite