Bahasa

AppNotificationProgressBar Kelas

Definisi

Ruang nama:
Microsoft.Windows.AppNotifications.Builder
Edit

Mewakili bilah kemajuan yang ditampilkan pada pemberitahuan aplikasi.

public ref class AppNotificationProgressBar sealed
/// [Windows.Foundation.Metadata.Activatable(65536, "Microsoft.Windows.AppNotifications.Builder.AppNotificationBuilderContract")]
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.Windows.AppNotifications.Builder.AppNotificationBuilderContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class AppNotificationProgressBar final
[Windows.Foundation.Metadata.Activatable(65536, "Microsoft.Windows.AppNotifications.Builder.AppNotificationBuilderContract")]
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.Windows.AppNotifications.Builder.AppNotificationBuilderContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class AppNotificationProgressBar
function AppNotificationProgressBar()
Public NotInheritable Class AppNotificationProgressBar
Warisan
Object Platform::Object IInspectable AppNotificationProgressBar
Atribut
ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Contoh

Contoh berikut menunjukkan penambahan bilah kemajuan ke payload XML untuk pemberitahuan aplikasi.

var notification = new AppNotificationBuilder()
    .AddText("Downloading your weekly playlist...")
    .AddProgressBar(new AppNotificationProgressBar()
        .BindTitle()
        .BindStatus()
        .BindValue()
        .BindValueStringOverride())
        .SetTag(tagName)
        .SetGroup(groupName))
    .BuildNotification();

var data = new AppNotificationProgressData (sequenceNumber /* Sequence number */);
data.Title = "Retreiving files"; // Binds to {progressTitle} in xml payload
data.Value = (double) currentFile / totalFiles; // Binds to {progressValue} in xml payload
data.ValueStringOverride = String.Format("{0}/{1} files", currentFile, totalFiles); // Binds to {progressValueString} in xml payload
data.Status = "Downloading..."; // Binds to {progressStatus} in xml payload

notification.Progress = data;

AppNotificationManager.Default.Show(notification);

Payload XML yang dihasilkan:

<toast>
    <visual>
        <binding template='ToastGeneric'>
            <text>Downloading your weekly playlist...</text>
            <progress title='{progressTitle}' status='{progressStatus}' value='{progressValue}' valueStringOverride='{progressValueString}'/>
        </binding>
    </visual>
</toast>

Perbarui nilai terikat dengan memanggil AppNotificationManager.UpdateAsync) dan tentukan tag, dan secara opsional grup, dari tag yang ingin Anda perbarui.

private async Task UpdateProgressBar()
{
    var data = new AppNotificationProgressData(sequenceNumber /* Sequence number */);
    data.Title = "Retreiving files"; // Binds to {progressTitle} in xml payload
    data.Value = (double)currentFile / totalFiles; // Binds to {progressValue} in xml payload
    data.ValueStringOverride = String.Format("{0}/{1} files", currentFile, totalFiles); // Binds to {progressValueString} in xml payload
    data.Status = (currentFile < totalFiles) ? "Downloading..." : "Complete!"; // Binds to {progressStatus} in xml payload

    await AppNotificationManager.Default.UpdateAsync(data, tagName, groupName);
}

Keterangan

Cuplikan layar berikut menunjukkan pemberitahuan aplikasi dengan bilah kemajuan.

Cuplikan layar pemberitahuan aplikasi dengan bilah kemajuan.

Tambahkan bilah kemajuan ke payload XML untuk pemberitahuan aplikasi dengan memanggil AppNotificationBuilder.AddProgressBar).

Untuk panduan tentang menggunakan API AppNotificationBuilder untuk membuat UI untuk pemberitahuan aplikasi, lihat konten pemberitahuan aplikasi .

Untuk informasi referensi tentang skema XML untuk pemberitahuan aplikasi, lihat skema konten pemberitahuan aplikasi .

Konstruktor

Nama Deskripsi
AppNotificationProgressBar()

Menginisialisasi instans baru kelas AppNotificationProgressBar .

Properti

Nama Deskripsi
Status

Mendapatkan atau mengatur teks status bilah kemajuan pemberitahuan aplikasi.
Title

Mendapatkan atau mengatur teks judul bilah kemajuan pemberitahuan aplikasi.
Value

Mendapatkan atau mengatur nilai kemajuan bilah kemajuan pemberitahuan aplikasi.
ValueStringOverride

Mendapatkan atau mengatur penimpaan string nilai dari bilah kemajuan pemberitahuan aplikasi.

Metode

Nama Deskripsi
BindStatus()

Mengikat properti AppNotificationProgressBar.Status .
BindTitle()

Mengikat properti AppNotificationProgressBar.Title .
BindValue()

Mengikat properti AppNotificationProgressBar.Value .
BindValueStringOverride()

Mengikat properti AppNotificationProgressBar.ValueStringOverride .
SetStatus(String)

Mengatur teks status bilah kemajuan pemberitahuan aplikasi.
SetTitle(String)

Mengatur teks judul bilah kemajuan pemberitahuan aplikasi.
SetValue(Double)

Mengatur nilai kemajuan bilah kemajuan pemberitahuan aplikasi.
SetValueStringOverride(String)

Mengatur penggantian string nilai dari bilah kemajuan pemberitahuan aplikasi.

Berlaku untuk