BadgeUpdater Clase

Definición

Espacio de nombres:

Windows.UI.Notifications

Novedades una superposición de distintivo en el icono específico al que está enlazado el actualizador.

public ref class BadgeUpdater sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class BadgeUpdater final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class BadgeUpdater

Public NotInheritable Class BadgeUpdater

Herencia

Object Platform::Object IInspectable BadgeUpdater

Atributos

ContractVersionAttribute 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 ejemplo siguiente se muestra el uso de Update para enviar una actualización numérica del distintivo al icono de la aplicación que llama.

function sendBadgeNotification() {
    var Notifications = Windows.UI.Notifications;
    var badgeXml;
    var badgeAttributes;

    // Get an XML DOM version of a specific template by using getTemplateContent.
    badgeXml = Notifications.BadgeUpdateManager.getTemplateContent(Notifications.BadgeTemplateType.badgeNumber);
    badgeAttributes = badgeXml.getElementsByTagName("badge");
    badgeAttributes[0].setAttribute("value", "7");

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

    // Send the badge notification to the app's tile.
    Notifications.BadgeUpdateManager.createBadgeUpdaterForApplication().update(badgeNotification);
}

Comentarios

Para obtener una instancia de este objeto, llame al método BadgeUpdateManager.CreateBadgeUpdaterForApplication o BadgeUpdateManager.CreateBadgeUpdaterForSecondaryTile .

Cuando se crea, BadgeUpdater se enlaza a una aplicación específica o a un icono secundario, por lo que los métodos de esta clase solo afectan al icono único al que está enlazada la instancia de objeto.

Métodos

Clear()	Quita el distintivo del icono al que está enlazado el actualizador.
StartPeriodicUpdate(Uri, DateTime, PeriodicUpdateRecurrence)	Comienza una serie de actualizaciones temporales para el distintivo de un recurso web al que está enlazado el actualizador. Novedades comienzan en un momento especificado. Tenga en cuenta que solo se permiten recursos web (http/https) en una actualización periódica.
StartPeriodicUpdate(Uri, PeriodicUpdateRecurrence)	Comienza una serie de actualizaciones temporales para el distintivo de un recurso web al que está enlazado el actualizador, empezando inmediatamente. Tenga en cuenta que solo se permiten recursos web (http/https) en una actualización periódica.
StopPeriodicUpdate()	Cancela la serie actual de actualizaciones temporales para el distintivo al que está enlazado el actualizador.
Update(BadgeNotification)	Aplica un cambio al glifo o número del distintivo.

Consulte también

• Ejemplo de iconos y distintivos de la aplicación
• 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
• Información general sobre distintivos