Toast headers

Puede agrupar visualmente un conjunto de notificaciones relacionadas dentro del Centro de actividades mediante un encabezado de notificación.

Como se muestra a continuación, esta conversación de grupo se unifica bajo un único encabezado, "Camping!!". Cada mensaje individual de la conversación es una notificación emergente independiente que comparte el mismo encabezado.

También puedes agrupar visualmente las notificaciones por categoría, como recordatorios de vuelos, seguimiento de paquetes, etc.

Agregar un encabezado a una notificación emergente

Aquí te mostramos cómo agregar un encabezado a una notificación emergente.

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. Agregue el de encabezado de a la toastContent de
2. Asigne las propiedades requeridas Id , Título y Argumentos
3. Envío de la notificación (más información)
4. En otra notificación, utilice el mismo encabezado Id para unificarlos dentro del encabezado. El Id de es la única propiedad que se usa para determinar si se deben agrupar las notificaciones, lo que significa que el título de y los argumentos pueden ser diferentes. Se utilizan el título y los argumentos de la notificación más reciente dentro de un grupo. Si se elimina esa notificación, entonces el Título y los Argumentos vuelven a la siguiente notificación más reciente.

Controlar la activación desde un encabezado

Los usuarios pueden hacer clic en los encabezados para que el usuario pueda hacer clic en el encabezado para obtener más información de la aplicación.

Por lo tanto, las aplicaciones pueden proporcionar argumentos en el encabezado, similar a los argumentos de inicio en el propio toast.

La activación se controla de forma idéntica a la activación normal de las notificaciones, lo que significa que puede recuperar estos argumentos en el método OnActivated de App.xaml.cs como cuando el usuario hace clic en el cuerpo de la notificación o en un botón de la notificación.

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

El encabezado separa visualmente y agrupa las notificaciones. No cambia ninguna otra logística sobre el número máximo de notificaciones que una aplicación puede tener (20) y el comportamiento primero en salir de la lista de notificaciones.

El orden de las notificaciones dentro de los encabezados es el siguiente... Para una aplicación determinada, la notificación más reciente de la aplicación (y todo el grupo de encabezados si parte de un encabezado) aparecerá primero.

El id. de puede ser cualquier cadena que elija. No hay restricciones de longitud ni caracteres en ninguna de las propiedades de ToastHeader. La única restricción es que todo el contenido de la notificación XML no puede ser superior a 5 KB.

La creación de encabezados no cambia el número de notificaciones que se muestran en el Centro de actividades antes de que aparezca el botón "Ver más" (este número es 3 de forma predeterminada y el usuario puede configurarlo para cada aplicación en configuración del sistema para las notificaciones).

Al hacer clic en el encabezado, al igual que al hacer clic en el título de la aplicación, no se borran las notificaciones que pertenecen a este encabezado (la aplicación debe usar las API del sistema para borrar las notificaciones pertinentes).

Related topics

• Enviar una notificación emergente local y manejar la activación
• Documentación del contenido del Toast