Partilhar via

Mensagem de ativação de atualização pendente

Você pode usar PendingUpdate para criar interações em múltiplas etapas nas suas notificações de sistema. Por exemplo, como visto abaixo, você pode criar uma série de notificações em que as notificações subsequentes dependem das respostas das notificações anteriores.

Toast com atualização pendente

Important

Requer Atualização do Desktop Fall Creators e 2.0.0 da biblioteca de Notificações: Você deve estar executando a compilação 16299 ou posterior da Área de Trabalho para ver o trabalho de atualização pendente. Você deve usar a versão 2.0.0 ou posterior do biblioteca NuGet de Notificações do Kit de Ferramentas da Comunidade UWP para atribuir PendingUpdate em seus botões. PendingUpdate só é suportado no Desktop e será ignorado em outros dispositivos.

Prerequisites

Este artigo pressupõe um conhecimento prático de...

Overview

Para implementar uma notificação do sistema que usa a atualização pendente como seu comportamento após a ativação...

  1. Nos botões de ativação em segundo plano dos toast, especifique um AfterActivationBehavior de PendingUpdate após a ativação, usando as etiquetas ,, ,.

  2. Atribua um Tag (e opcionalmente um Grupo) ao enviar a sua notificação pop-up

  3. Quando o usuário clicar no botão, a tarefa em segundo plano será ativada e a notificação do sistema será mantida na tela em um estado de atualização pendente

  4. Na sua tarefa em segundo plano, envie uma nova notificação com o novo conteúdo, usando o mesmo Tag e Grupo

Assign PendingUpdate

Nos botões de ativação em segundo plano, defina o AfterActivationBehavior para PendingUpdate. Observe que isso só funciona para botões que têm um ActivationType de Background.

new ToastContentBuilder()

    .AddText("Would you like to order lunch today?")

    .AddButton(new ToastButton("Yes", "action=orderLunch")
    {
        ActivationType = ToastActivationType.Background,

        ActivationOptions = new ToastActivationOptions()
        {
            AfterActivationBehavior = ToastAfterActivationBehavior.PendingUpdate
        }
    });

Usar uma tag na notificação

Para substituir posteriormente a notificação, temos que atribuir a Tag (e, opcionalmente, o Grupo) na notificação.

// Create the notification
var notif = new ToastNotification(content.GetXml())
{
    Tag = "lunch"
};

// And show it
ToastNotificationManager.CreateToastNotifier().Show(notif);

Substitua o toast por novo conteúdo

Em resposta ao utilizador clicar no seu botão, a sua tarefa em segundo plano é acionada e você precisa substituir a notificação por novo conteúdo. Você substitui a notificação do sistema simplesmente enviando uma nova notificação do sistema com o mesmo Tag e Grupo.

É altamente recomendável definir o áudio como silencioso em substituições em resposta a um clique no botão, uma vez que o utilizador já está a interagir com a sua notificação.

// Generate new content
ToastContent content = new ToastContent()
{
    ...

    // We disable audio on all subsequent toasts since they appear right after the user
    // clicked something, so the user's attention is already captured
    Audio = new ToastAudio() { Silent = true }
};

// Create the new notification
var notif = new ToastNotification(content.GetXml())
{
    Tag = "lunch"
};

// And replace the old one with this one
ToastNotificationManager.CreateToastNotifier().Show(notif);
  • Last updated on