Toast headers

Você pode agrupar visualmente um conjunto de notificações relacionadas dentro da Central de Ações usando um cabeçalho de notificação em suas notificações.

Como visto abaixo, esta conversa em grupo é unificada sob um único cabeçalho, "Camping!!". Cada mensagem individual na conversa é uma notificação de brinde separada, compartilhando o mesmo cabeçalho de notificação.

Você também pode optar por agrupar visualmente suas notificações por categoria, como lembretes de voo, rastreamento de pacotes e muito mais.

Adicionar um cabeçalho a uma mensagem de toast

Veja como adicionar um cabeçalho a uma notificação de aviso.

new ToastContentBuilder()
    .AddHeader("6289", "Camping!!", "action=openConversation&id=6289")
    .AddText("Anyone have a sleeping bag I can borrow?");

<toast>

    <header
        id="6289"
        title="Camping!!"
        arguments="action=openConversation&amp;id=6289"/>

    <visual>
        ...
    </visual>

</toast>

In summary...

1. Adicione o Cabeçalho ao seu ToastContent
2. Atribua as propriedades necessárias Id, Títuloe Argumentos.
3. Envie sua notificação (saiba mais)
4. Em outra notificação, use o mesmo cabeçalho Id para unificá-los sob o mesmo cabeçalho. A Id é a única propriedade usada para determinar se as notificações devem ser agrupadas, o que significa que o Título e os Argumentos podem ser diferentes. São usados o Título e os Argumentos da notificação mais recente dentro de um grupo. Se essa notificação for removida, o Título e os Argumentos voltam para a notificação mais recente seguinte.

Manipular a ativação a partir de um cabeçalho

Os cabeçalhos são clicáveis pelos usuários, para que o usuário possa clicar no cabeçalho para saber mais do seu aplicativo.

Portanto, os aplicativos podem fornecer Argumentos no cabeçalho, semelhante aos argumentos de inicialização na própria notificação pop-up.

A ativação é tratada de forma idêntica à ativação normal de 'toast', o que significa que pode recuperar esses argumentos no método OnActivated de App.xaml.cs, assim como faz quando o utilizador clica no corpo de um 'toast' ou num botão de um 'toast'.

protected override void OnActivated(IActivatedEventArgs e)
{
    // Handle toast activation
    if (e is ToastNotificationActivatedEventArgs)
    {
        // Arguments specified from the header
        string arguments = (e as ToastNotificationActivatedEventArgs).Argument;
    }
}

Additional info

O cabeçalho separa visualmente e agrupa as notificações. Ele não altera nenhuma outra logística sobre o número máximo de notificações que um aplicativo pode ter (20) e o comportamento de primeiro a entrar e primeiro a sair da lista de notificações.

A ordem das notificações nos cabeçalhos é a seguinte... Para um determinado aplicativo, a notificação mais recente do aplicativo (e todo o grupo de cabeçalhos, se fizer parte de um cabeçalho) aparecerá primeiro.

O de ID pode ser qualquer string que você escolher. Não há restrições de comprimento ou caracteres em nenhuma das propriedades em ToastHeader. A única restrição é que todo o conteúdo da notificação em XML não pode ser maior que 5 KB.

A criação de cabeçalhos não altera o número de notificações mostradas na Central de Ações antes que o botão "Ver mais" apareça (esse número é 3 por padrão e pode ser configurado pelo usuário para cada aplicativo nas Configurações do sistema para notificações).

Clicar no cabeçalho, assim como clicar no título do aplicativo, não limpa nenhuma notificação pertencente a esse cabeçalho (seu aplicativo deve usar as APIs do sistema para limpar as notificações relevantes).

Related topics

• Enviar um toast local e manipular a ativação
• Documentação de conteúdo do Toast