Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
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. |
|
<badge value="1"/> |
| Cualquier número 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 |
|
<badge value="activity"/> |
| alarm |
|
<badge value="alarm"/> |
| alert | Insignia de glifo que indica el estado de «alerta». | <badge value="alert"/> |
| attention |
|
<badge value="attention"/> |
| available |
|
<badge value="available"/> |
| away |
|
<badge value="away"/> |
| busy |
|
<badge value="busy"/> |
| error |
|
<badge value="error"/> |
| newMessage |
|
<badge value="newMessage"/> |
| paused |
|
<badge value="paused"/> |
| playing |
|
<badge value="playing"/> |
| unavailable |
|
<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.