AppNotificationProgressBar 클래스

정의

네임스페이스:

Microsoft.Windows.AppNotifications.Builder

앱 알림에 표시되는 진행률 표시줄을 나타냅니다.

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

상속

Object Platform::Object IInspectable AppNotificationProgressBar

특성

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

예제

다음 예제에서는 앱 알림에 대한 XML 페이로드에 진행률 표시줄을 추가하는 방법을 보여 줍니다.

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

결과 XML 페이로드:

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

AppNotificationManager.UpdateAsync를 호출하고 업데이트할 태그의 태그와 선택적으로 그룹을 지정하여 바인딩된 값을 업데이트합니다.

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

설명

다음 스크린샷은 진행률 표시줄이 있는 앱 알림을 보여줍니다.

AppNotificationBuilder.AddProgressBar를 호출하여 앱 알림에 대한 XML 페이로드에 진행률 표시줄을 추가합니다.

AppNotificationBuilder API를 사용하여 앱 알림에 대한 UI를 만드는 방법에 대한 지침은 앱 알림 콘텐츠를 참조하세요.

앱 알림에 대한 XML 스키마에 대한 참조 정보는 앱 알림 콘텐츠 스키마를 참조하세요.

생성자

AppNotificationProgressBar()

AppNotificationProgressBar 클래스의 새 instance 초기화합니다.

속성

Status	앱 알림 진행률 표시줄의 상태 텍스트를 가져오거나 설정합니다.
Title	앱 알림 진행률 표시줄의 제목 텍스트를 가져오거나 설정합니다.
Value	앱 알림 진행률 표시줄의 진행률 값을 가져오거나 설정합니다.
ValueStringOverride	앱 알림 진행률 표시줄의 값 문자열 재정의를 가져오거나 설정합니다.

메서드

BindStatus()	AppNotificationProgressBar.Status 속성을 바인딩합니다.
BindTitle()	AppNotificationProgressBar.Title 속성을 바인딩합니다.
BindValue()	AppNotificationProgressBar.Value 속성을 바인딩합니다.
BindValueStringOverride()	AppNotificationProgressBar.ValueStringOverride 속성을 바인딩합니다.
SetStatus(String)	앱 알림 진행률 표시줄의 상태 텍스트를 설정합니다.
SetTitle(String)	앱 알림 진행률 표시줄의 제목 텍스트를 설정합니다.
SetValue(Double)	앱 알림 진행률 표시줄의 진행률 값을 설정합니다.
SetValueStringOverride(String)	앱 알림 진행률 표시줄의 값 문자열 재정의를 설정합니다.