Compartir a través de


Notificaciones de insignias para aplicaciones de Windows

Una insignia de notificación transmite información de resumen o estado específica de tu 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 insignias se pueden mostrar en todos los tamaños de mosaico.

Note

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

Emblemas numéricos

Value Badge XML
Número comprendido entre 1 y 99. Un valor de 0 es equivalente a la representación del glifo "none" y borrará el emblema. un distintivo numérico inferior a 100. <badge value="1"/>
Cualquier número mayor que 99. un distintivo numérico mayor que 99. <badge value="100"/>

Distintivos de glifo

En lugar de un número, una insignia puede exhibir uno de un conjunto no extensible de glifos de estado.

Status Glyph XML
none (No se muestra ninguna insignia). <badge value="none"/>
activity Distintivo de glifo que indica el estado de <badge value="activity"/>
alarm Un distintivo de glifo que indica el estado de la <badge value="alarm"/>
alert Insignia de glifo que indica el estado de «alerta». <badge value="alert"/>
attention Distintivo de glifo que indica el estado de <badge value="attention"/>
available Distintivo de glifo que indica el estado <badge value="available"/>
away Una insignia de glifo que denota el estado <badge value="away"/>
busy Distintivo de glifo que indica el estado <badge value="busy"/>
error Distintivo de glifo que indica el estado <badge value="error"/>
newMessage Distintivo de glifo que indica el estado <badge value="newMessage"/>
paused Distintivo de glifo que indica el estado <badge value="paused"/>
playing Distintivo de glifo que indica el estado <badge value="playing"/>
unavailable Distintivo de glifo que indica el estado <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();
}

Obtención del código de ejemplo

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