AppNotificationProgressBar.SetValueStringOverride(String) Método

Definição

Namespace:

Microsoft.Windows.AppNotifications.Builder

Define a substituição da cadeia de caracteres de valor de uma barra de progresso de notificação do aplicativo.

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

Parâmetros

value

String

Platform::String

winrt::hstring

Uma cadeia de caracteres que contém o texto de substituição da cadeia de caracteres de valor.

Retornos

AppNotificationProgressBar

Retorna a instância AppNotificationProgressBar para que chamadas de método adicionais possam ser encadeadas.

Exemplos

O exemplo a seguir ilustra como definir a propriedade ValueStringOverride de uma barra de progresso de notificação do aplicativo.

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

O conteúdo XML resultante:

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

Comentários

Você também pode definir o texto de substituição da cadeia de caracteres de valor com a propriedade AppNotificationProgressBar.ValueStringOverride.

Você pode definir o texto do título usando a associação de dados chamando AppNotificationProgressBar.BindValueStringOverride. Atualize o valor de status associado atribuindo um objeto AppNotificationProgressData à propriedade AppNotification.Progress.

Para obter diretrizes sobre como usar as APIs AppNotificationBuilder para criar a interface do usuário para notificações de aplicativo, consulte conteúdo de notificação do aplicativo.

Para obter informações de referência sobre o esquema XML para notificações de aplicativo, consulte esquema de conteúdo de notificação do aplicativo.