Notificaciones de distintivos para aplicaciones de Windows

  • Artículo
Icono con un distintivo numérico que muestra el número 63 para indicar 63 correos no leídos.
Un icono con una notificación numérica que muestra
el número 63 para indicar que hay 63 correos electrónicos sin leer.

Las notificaciones transmiten información de estado o resumen de la aplicación y son específicos de la aplicación. Las notificaciones ser numéricas (1-99) o pueden formar parte de un conjunto de glifos proporcionados por el sistema. Algunos ejemplos de la información que se transmite mejor mediante una notificación son el estado de conexión de red de un juego en línea, el estado de un usuario de una aplicación de mensajería, la cantidad de correos electrónicos sin leer en una aplicación de correo electrónico y la cantidad de entradas nuevas en una aplicación de medios sociales.

Las notificaciones aparecen en el icono de barra de tareas de la aplicación y en la esquina inferior derecha de su ventana de Inicio, independientemente de si la aplicación está en ejecución. Las notificaciones se pueden mostrar en ventanas de todos los tamaños.

Nota:

No puedes proporcionar tu propia imagen de notificación (solo se pueden usar las imágenes de notificación proporcionadas por el sistema).

Notificaciones numéricas

Valor Distintivo XML
Un número de 1 a 99. Un valor de 0 es equivalente al valor de glifo "ninguno" y borrará la notificación. Una notificación inferior a 100. <badge value="1"/>
Cualquier número superior a 99. Una notificación mayor que 99. <badge value="100"/>

Notificaciones de glifo

En lugar de un número, una notificación puede mostrar un elemento de un conjunto no extensible de glifos de estado.

Estado Glifo XML
ninguno (No se muestran notificaciones.) <badge value="none"/>
activity <badge value="activity"/>
alarma <badge value="alarm"/>
alerta <badge value="alert"/>
atención <badge value="attention"/>
disponible <badge value="available"/>
ausente <badge value="away"/>
ocupado <badge value="busy"/>
error <badge value="error"/>
newMessage <badge value="newMessage"/>
en pausa <badge value="paused"/>
reproducción <badge value="playing"/>
no disponible <badge value="unavailable"/>

Crear una notificación

En estos ejemplos se muestra cómo crear una actualización de distintivos.

Crear una notificación numérica

private void setBadgeNumber(int num)
{

    // Get the blank badge XML payload for a badge number
    XmlDocument badgeXml = 
        BadgeUpdateManager.GetTemplateContent(BadgeTemplateType.BadgeNumber);

    // Set the value of the badge in the XML to our number
    XmlElement badgeElement = badgeXml.SelectSingleNode("/badge") as XmlElement;
    badgeElement.SetAttribute("value", num.ToString());

    // Create the badge notification
    BadgeNotification badge = new BadgeNotification(badgeXml);

    // Create the badge updater for the application
    BadgeUpdater badgeUpdater = 
        BadgeUpdateManager.CreateBadgeUpdaterForApplication();

    // And update the badge
    badgeUpdater.Update(badge);

}

Crear una notificación de glifo

private void updateBadgeGlyph()
{
    string badgeGlyphValue = "alert";

    // Get the blank badge XML payload for a badge glyph
    XmlDocument badgeXml = 
        BadgeUpdateManager.GetTemplateContent(BadgeTemplateType.BadgeGlyph);

    // Set the value of the badge in the XML to our glyph value
    Windows.Data.Xml.Dom.XmlElement badgeElement = 
        badgeXml.SelectSingleNode("/badge") as Windows.Data.Xml.Dom.XmlElement;
    badgeElement.SetAttribute("value", badgeGlyphValue);

    // Create the badge notification
    BadgeNotification badge = new BadgeNotification(badgeXml);

    // Create the badge updater for the application
    BadgeUpdater badgeUpdater = 
        BadgeUpdateManager.CreateBadgeUpdaterForApplication();

    // And update the badge
    badgeUpdater.Update(badge);

}

Borrar una notificación

private void clearBadge()
{
    BadgeUpdateManager.CreateBadgeUpdaterForApplication().Clear();
}

Obtención del código de ejemplo

  • Muestra de notificaciones
    Muestra cómo crear iconos dinámicos, enviar actualizaciones de notificación y mostrar notificaciones del sistema.