BadgeUpdateManager Clase

Definición

Espacio de nombres:

Windows.UI.Notifications

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)]
/// [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)]
[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.

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 distintivo
• Información general sobre distintivos