BadgeNotification Clase

Definición

Espacio de nombres:

Windows.UI.Notifications

Define el contenido, los metadatos asociados y la hora de expiración de una actualización de la superposición de distintivo de un icono. Un distintivo puede mostrar un número de 1 a 99 o un glifo de estado.

public ref class BadgeNotification sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
/// [Windows.Foundation.Metadata.Activatable(Windows.UI.Notifications.IBadgeNotificationFactory, 65536, "Windows.Foundation.UniversalApiContract")]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class BadgeNotification final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
[Windows.Foundation.Metadata.Activatable(typeof(Windows.UI.Notifications.IBadgeNotificationFactory), 65536, "Windows.Foundation.UniversalApiContract")]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class BadgeNotification

function BadgeNotification(content)

Public NotInheritable Class BadgeNotification

Herencia

Object Platform::Object IInspectable BadgeNotification

Atributos

ActivatableAttribute ContractVersionAttribute ThreadingAttribute MarshalingBehaviorAttribute

Requisitos de Windows

Familia de dispositivos	Windows 10 (se introdujo en la versión 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract	Windows.Foundation.UniversalApiContract (se introdujo en la versión v1.0)

Ejemplos

En el código de ejemplo siguiente se usa el método BadgeNotification para crear una notificación de distintivo numérico. Si usó este método para establecer el valor en "0", borraría el distintivo.

var Notifications = Windows.UI.Notifications;

var badgeXml = Notifications.BadgeUpdateManager.getTemplateContent(Notifications.BadgeTemplateType.badgeNumber);
var badgeAttributes = badgeXml.getElementsByTagName("badge");
badgeAttributes[0].setAttribute("value", "26");

// Create a badge notification from XML
var badgeNotification = new Notifications.badgeNotification(badgeXml);

En el código de ejemplo siguiente se usa el método BadgeNotification para crear una notificación de distintivo de glifo. Si usó este método para establecer el valor en "none", borraría el distintivo.

var Notifications = Windows.UI.Notifications;

var badgeXml = Notifications.BadgeUpdateManager.getTemplateContent(Notifications.BadgeTemplateType.badgeNumber);
var badgeAttributes = badgeXml.getElementsByTagName("badge");
badgeAttributes[0].setAttribute("value", "alert");

// Create a badge notification from XML
var badgeNotification = new Notifications.badgeNotification(badgeXml);

Constructores

BadgeNotification(XmlDocument)

Crea e inicializa una nueva instancia de BadgeNotification.

Propiedades

Content	Obtiene el XML que define el valor o glifo usado como distintivo del icono.
ExpirationTime	Obtiene o establece la hora en que Windows quitará el distintivo del icono. De forma predeterminada, las notificaciones de distintivo local no expiran y las notificaciones de notificación push, periódicas y programadas expiran después de tres días. Se recomienda establecer explícitamente un tiempo de expiración para evitar contenido obsoleto.

Consulte también

• Ejemplo de iconos y distintivos de la aplicación
• Información general sobre distintivos
• Directrices y lista de comprobación de iconos y distintivos
• Cómo borrar un distintivo
• Cómo enviar un glifo o un distintivo numérico en una notificación local
• Cómo configurar notificaciones periódicas para distintivos
• Cómo actualizar un distintivo mediante notificaciones de inserción
• Esquema XML de distintivo