AppNotificationBuilder.AddProgressBar(AppNotificationProgressBar) Método

Definição

Namespace:

Microsoft.Windows.AppNotifications.Builder

Adiciona uma barra de progresso ao conteúdo XML para uma notificação de aplicativo.

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

Um AppNotificationProgressBar que representa a barra de progresso a ser adicionada à notificação.

Retornos

AppNotificationBuilder

Retorna a instância AppNotificationBuilder para que chamadas de método adicionais possam ser encadeadas.

Exemplos

O exemplo a seguir demonstra a adição de uma caixa de combinação a uma notificação de aplicativo.

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

O conteúdo 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>

Comentários

Associe os campos de um AppNotificationProgressData para definir os valores iniciais e os status atualizados da barra de progresso. Para obter informações sobre a associação de dados a uma barra de progresso em uma notificação de aplicativo, consulte Barra de progresso da notificação de aplicativo e associação de dados.

Para obter diretrizes sobre como usar as APIs AppNotificationBuilder para criar a interface do usuário para notificações de aplicativo, consulte Conteúdo da notificação de aplicativo.

Para obter informações de referência sobre o esquema XML para notificações de aplicativo, consulte Esquema de conteúdo de notificação de aplicativo.