AppNotificationBuilder.AddProgressBar(AppNotificationProgressBar) Метод

Определение

Пространство имен:

Microsoft.Windows.AppNotifications.Builder

Добавляет индикатор выполнения в полезные данные XML для уведомления приложения.

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

Параметры

value

AppNotificationProgressBar

AppNotificationProgressBar, представляющий индикатор выполнения, добавляемый в уведомление.

Возвращаемое значение

AppNotificationBuilder

Возвращает экземпляр AppNotificationBuilder , чтобы можно было связать в цепочку дополнительные вызовы методов.

Примеры

В следующем примере показано добавление поля со списком в уведомление приложения.

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

Результирующие полезные данные XML:

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

Комментарии

Привяжите поля AppNotificationProgressData , чтобы задать начальные значения и обновленное состояние индикатора выполнения. Сведения о привязке данных к индикатору выполнения в уведомлении приложения см. в разделе Индикатор выполнения уведомлений приложения и привязка данных.

Инструкции по использованию API AppNotificationBuilder для создания пользовательского интерфейса для уведомлений приложений см. в разделе Содержимое уведомлений приложений.

Справочные сведения о схеме XML для уведомлений приложений см. в разделе Схема содержимого уведомлений приложений.