AppNotificationBuilder.AddProgressBar(AppNotificationProgressBar) Método

Definición

Espacio de nombres:

Microsoft.Windows.AppNotifications.Builder

Agrega una barra de progreso a la carga XML de una notificación de aplicación.

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

Parámetros

value

AppNotificationProgressBar

AppNotificationProgressBar que representa la barra de progreso que se va a agregar a la notificación.

Devoluciones

AppNotificationBuilder

Devuelve la instancia de AppNotificationBuilder para que se puedan encadenar llamadas de método adicionales.

Ejemplos

En el ejemplo siguiente se muestra cómo agregar un cuadro combinado a una notificación de aplicación.

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

La carga XML resultante:

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

Comentarios

Enlace los campos de appNotificationProgressData para establecer los valores iniciales y el estado actualizado de la barra de progreso. Para obtener información sobre el enlace de datos a una barra de progreso en una notificación de aplicación, consulte Barra de progreso de notificación de aplicación y enlace de datos.

Para obtener instrucciones sobre el uso de las API de AppNotificationBuilder para crear la interfaz de usuario para las notificaciones de la aplicación, consulte Contenido de la notificación de la aplicación.

Para obtener información de referencia sobre el esquema XML para las notificaciones de aplicaciones, consulte Esquema de contenido de notificación de aplicaciones.