AppNotificationProgressBar.SetValueStringOverride(String) 方法

定义

命名空间:

Microsoft.Windows.AppNotifications.Builder

设置应用通知进度栏的值字符串替代。

public:
 virtual AppNotificationProgressBar ^ SetValueStringOverride(Platform::String ^ value) = SetValueStringOverride;

AppNotificationProgressBar SetValueStringOverride(winrt::hstring const& value);

public AppNotificationProgressBar SetValueStringOverride(string value);

function setValueStringOverride(value)

Public Function SetValueStringOverride (value As String) As AppNotificationProgressBar

参数

value

String

Platform::String

winrt::hstring

包含值字符串替代文本的字符串。

返回

AppNotificationProgressBar

返回 AppNotificationProgressBar 实例，以便可以链接其他方法调用。

示例

以下示例演示如何设置应用通知进度栏的 ValueStringOverride 属性。

 var notification = new AppNotificationBuilder()
    .AddText("Downloading your weekly playlist...")
    .AddProgressBar(new AppNotificationProgressBar()
        .SetTitle("Progress bar title")
        .SetValue(.5)
        .SetStatus("Downloading...")
        .SetValueStringOverride("1/2 files downloaded"))
    .BuildNotification();

AppNotificationManager.Default.Show(notification);

生成的 XML 有效负载：

<toast>
    <visual>
        <binding template='ToastGeneric'>
            <text>Downloading your weekly playlist...</text>
            <progress title='Progress bar title' status='Downloading...' value='0.5' valueStringOverride='1/2 files downloaded'/>
        </binding>
    </visual>
</toast>

注解

还可以使用 AppNotificationProgressBar.ValueStringOverride 属性设置值字符串替代文本。

可以通过调用 AppNotificationProgressBar.BindValueStringOverride 来使用数据绑定设置标题文本。 通过将 AppNotificationProgressData 对象分配给 AppNotification.Progress属性来更新绑定状态值。

有关使用 AppNotificationBuilder API 创建应用通知 UI 的指导，请参阅 应用通知内容。

有关应用通知的 XML 架构的参考信息，请参阅 应用通知内容架构。