Barra di stato dell'avviso popup e data binding

L'uso di un indicatore di stato all'interno della notifica di tipo avviso popup consente di comunicare lo stato delle operazioni a esecuzione prolungata all'utente, ad esempio download, rendering video, obiettivi di esercizio e altro ancora.

Un indicatore di stato all'interno di un avviso popup può essere "indeterminato" (nessun valore specifico, punti animati indica che si sta verificando un'operazione) o "determinato" (una percentuale specifica della barra viene riempita, ad esempio il 60%).

API importanti: classe NotificationData, metodo ToastNotifier.Update, classe ToastNotification

L'immagine seguente mostra un indicatore di stato determinato con tutte le proprietà corrispondenti etichettate.

Ecco come generare la notifica visualizzata in precedenza...

new ToastContentBuilder()
    .AddText("Downloading your weekly playlist...")
    .AddVisualChild(new AdaptiveProgressBar()
    {
        Title = "Weekly playlist",
        Value = 0.6,
        ValueStringOverride = "15/26 songs",
        Status = "Downloading..."
    });

<toast>
    <visual>
        <binding template="ToastGeneric">
            <text>Downloading your weekly playlist...</text>
            <progress
                title="Weekly playlist"
                value="0.6"
                valueStringOverride="15/26 songs"
                status="Downloading..."/>
        </binding>
    </visual>
</toast>

Tuttavia, è necessario aggiornare dinamicamente i valori dell'indicatore di stato in modo che sia effettivamente "live". A tale scopo, puoi usare il data binding per aggiornare l'avviso popup.

Uso del data binding per aggiornare un avviso popup

L'uso del data binding prevede i passaggi seguenti...

1. Costruzione del contenuto di tipo avviso popup che utilizza campi associati a dati
2. Assegnazione di un tag (e facoltativamente un gruppo) a ToastNotification
3. Definizione dei valori dei dati iniziali in ToastNotification
4. Invio dell'avviso popup
5. Utilizzo di tag e gruppo per aggiornare i valori dei dati con nuovi valori

Il frammento di codice seguente illustra i passaggi da 1 a 4. Il frammento di codice successivo mostrerà come aggiornare i valori dei dati di tipo avviso popup.

using Windows.UI.Notifications;
using Microsoft.Toolkit.Uwp.Notifications;
 
public void SendUpdatableToastWithProgress()
{
    // Define a tag (and optionally a group) to uniquely identify the notification, in order update the notification data later;
    string tag = "weekly-playlist";
    string group = "downloads";
 
    // Construct the toast content with data bound fields
    var content = new ToastContentBuilder()
        .AddText("Downloading your weekly playlist...")
        .AddVisualChild(new AdaptiveProgressBar()
        {
            Title = "Weekly playlist",
            Value = new BindableProgressBarValue("progressValue"),
            ValueStringOverride = new BindableString("progressValueString"),
            Status = new BindableString("progressStatus")
        })
        .GetToastContent();
 
    // Generate the toast notification
    var toast = new ToastNotification(content.GetXml());
 
    // Assign the tag and group
    toast.Tag = tag;
    toast.Group = group;
 
    // Assign initial NotificationData values
    // Values must be of type string
    toast.Data = new NotificationData();
    toast.Data.Values["progressValue"] = "0.6";
    toast.Data.Values["progressValueString"] = "15/26 songs";
    toast.Data.Values["progressStatus"] = "Downloading...";
 
    // Provide sequence number to prevent out-of-order updates, or assign 0 to indicate "always update"
    toast.Data.SequenceNumber = 1;
 
    // Show the toast notification to the user
    ToastNotificationManager.CreateToastNotifier().Show(toast);
}

Quindi, quando desideri modificare i valori di Dati , usa il metodo Update per fornire i nuovi dati senza ri-costruire l'intero payload dell'avviso popup.

using Windows.UI.Notifications;
 
public void UpdateProgress()
{
    // Construct a NotificationData object;
    string tag = "weekly-playlist";
    string group = "downloads";
 
    // Create NotificationData and make sure the sequence number is incremented
    // since last update, or assign 0 for updating regardless of order
    var data = new NotificationData
    {
        SequenceNumber = 2
    };

    // Assign new values
    // Note that you only need to assign values that changed. In this example
    // we don't assign progressStatus since we don't need to change it
    data.Values["progressValue"] = "0.7";
    data.Values["progressValueString"] = "18/26 songs";

    // Update the existing notification's data by using tag/group
    ToastNotificationManager.CreateToastNotifier().Update(data, tag, group);
}

L'uso del metodo Update anziché sostituire l'intero avviso popup garantisce anche che la notifica di tipo avviso popup rimanga nella stessa posizione nel Centro notifiche e non si sposta verso l'alto o verso il basso. Sarebbe abbastanza confuso per l'utente se l'avviso popup continuava a saltare all'inizio del Centro notifiche ogni pochi secondi mentre la barra di stato riempita!

Il metodo Update restituisce un'enumerazione NotificationUpdateResult, che consente di sapere se l'aggiornamento è riuscito o se non è stato possibile trovare la notifica ( il che significa che l'utente ha probabilmente ignorato la notifica ed è consigliabile interrompere l'invio di aggiornamenti). Non è consigliabile visualizzare un altro avviso popup finché l'operazione di stato non è stata completata(ad esempio al termine del download).

Elementi che supportano il data binding

Gli elementi seguenti nelle notifiche di tipo avviso popup supportano il data binding

• Tutte le proprietà in AdaptiveProgress
• La proprietà Text negli elementi AdaptiveText di primo livello

Aggiornare o sostituire una notifica

A partire da Windows 10, puoi sempre sostituire una notifica inviando un nuovo avviso popup con lo stesso tag e gruppo. Qual è la differenza tra la sostituzione dell'avviso popup e l'aggiornamento dei dati dell'avviso popup?

In generale, l'aggiornamento è utile per...

• Informazioni che cambiano frequentemente in un breve periodo di tempo e non richiedono che vengano portate all'inizio dell'attenzione dell'utente
• Modifiche minime al contenuto dell'avviso popup, ad esempio la modifica del 50% al 65%

Spesso, dopo il completamento della sequenza di aggiornamenti (come il file è stato scaricato), è consigliabile sostituire per il passaggio finale, perché...

• È probabile che la notifica finale abbia modifiche drastiche al layout, ad esempio la rimozione della barra di stato, l'aggiunta di nuovi pulsanti e così via
• L'utente potrebbe aver ignorato la notifica sullo stato di avanzamento in sospeso perché non è importante controllarlo, ma vuole comunque ricevere una notifica con un avviso popup quando l'operazione è stata completata

Argomenti correlati

• Il Intero esempio di codice su GitHub:
• Documentazione del contenuto di tipo avviso popup