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 的欄位，以設定進度列的初始值和更新狀態。 如需資料系結至應用程式通知中進度列的資訊，請參閱 應用程式通知進度列和資料系結。

如需使用 AppNotificationBuilder API 來建立應用程式通知 UI 的指引，請參閱 應用程式通知內容。

如需應用程式通知 XML 架構的參考資訊，請參閱 應用程式通知內容架構。