Compartir a través de


BadgeUpdater Clase

Definición

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)]
class BadgeUpdater final
/// [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)]
public sealed class BadgeUpdater
[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

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.

Se aplica a

Consulte también