Compartir a través de

BadgeUpdateManager Clase

  • Referencia

Definición

Espacio de nombres:
Windows.UI.Notifications
Editar

Crea objetos BadgeUpdater que se usan para manipular la superposición de distintivo de un icono. Esta clase también proporciona acceso al contenido XML de las plantillas de distintivo proporcionadas por el sistema para que pueda personalizar ese contenido para su uso en la actualización de los distintivos.

public ref class BadgeUpdateManager abstract sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
class BadgeUpdateManager final
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class BadgeUpdateManager final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
public static class BadgeUpdateManager
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public static class BadgeUpdateManager
Public Class BadgeUpdateManager
Herencia
Object Platform::Object IInspectable BadgeUpdateManager
Atributos
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 ejemplo siguiente se muestra el uso de GetTemplateContent para crear el contenido de un distintivo numérico y CreateBadgeUpdaterForApplication para enviar una actualización de distintivo numérico 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

Historial de versiones

Versión de Windows Versión del SDK Valor agregado
1607 14393 GetForUser

Métodos

CreateBadgeUpdaterForApplication()

Crea e inicializa una nueva instancia de BadgeUpdater, que permite cambiar la apariencia o el contenido del distintivo en el icono de la aplicación que realiza la llamada.
CreateBadgeUpdaterForApplication(String)

Crea e inicializa una nueva instancia de BadgeUpdater para el distintivo de un icono de aplicación especificado, normalmente el icono de otra aplicación del paquete. BadgeUpdater le permite cambiar la apariencia o el contenido de ese distintivo.
CreateBadgeUpdaterForSecondaryTile(String)

Crea e inicializa una nueva instancia de BadgeUpdater, que permite cambiar la apariencia o el contenido de un distintivo en un icono secundario. El icono puede pertenecer a la aplicación que llama o a cualquier otra aplicación del mismo paquete.
GetForUser(User)

Crea e inicializa un nuevo BadgeUpdateManagerForUser para el usuario especificado, lo que le permite cambiar la apariencia o el contenido del distintivo en un icono para un usuario específico.
GetTemplateContent(BadgeTemplateType)

Obtiene el contenido XML de una de las plantillas de distintivo predefinidas para que pueda personalizarlo para una actualización de distintivo.

Se aplica a

Consulte también