Compartir a través de


Notificaciones de distintivos para aplicaciones de Windows

Las notificaciones transmiten información de estado o resumen de la aplicación y son específicos de la aplicación. Pueden ser numéricos (1-99) o uno de un conjunto de glifos proporcionados por el sistema. Algunos ejemplos de información que mejor se transmiten a través de un distintivo incluyen el estado de conexión de red en un juego en línea, el estado del usuario en una aplicación de mensajería, el número de correos no leídos en una aplicación de correo y el número de nuevas publicaciones en una aplicación de redes sociales.

Los distintivos de notificación aparecen en el icono de la barra de tareas de la aplicación y en la esquina inferior derecha del icono de inicio, independientemente de si la aplicación se está ejecutando. Las notificaciones se pueden mostrar en todos los tamaños de mosaico.

Nota:

No puede proporcionar su propia imagen de distintivo; solo se pueden usar imágenes de distintivo proporcionadas por el sistema.

Distintivos numéricos

Valor Notificación XML
Número comprendido entre 1 y 99. Un valor de 0 es equivalente al valor del glifo "none" y borrará la notificación. Un distintivo numérico menor que 100. <badge value="1"/>
Cualquier número mayor que 99. Distintivo numérico mayor que 99. <badge value="100"/>

Distintivos de glifo

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

Estado Glifo XML
None (No se muestra ninguna notificación). <badge value="none"/>
activity <badge value="activity"/>
alarma <badge value="alarm"/>
alerta <badge value="alert"/>
atención <badge value="attention"/>
disponible <badge value="available"/>
lejos <badge value="away"/>
busy <badge value="busy"/>
error <badge value="error"/>
newMessage <badge value="newMessage"/>
Pausa <badge value="paused"/>
Jugando <badge value="playing"/>
no disponible <badge value="unavailable"/>

Creación de un distintivo

Estos ejemplos muestran cómo crear una actualización de distintivos.

Creación de un distintivo numérico

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

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

Obtener el código de ejemplo

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