BadgeUpdateManager Classe

Definição

Namespace:

Windows.UI.Notifications

Cria objetos BadgeUpdater que você usa para manipular a sobreposição de selo de um bloco. Essa classe também fornece acesso ao conteúdo XML dos modelos de selo fornecidos pelo sistema para que você possa personalizar esse conteúdo para uso na atualização de seus selos.

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

Herança

Object Platform::Object IInspectable BadgeUpdateManager

Atributos

ContractVersionAttribute ThreadingAttribute MarshalingBehaviorAttribute

Requisitos do Windows

Família de dispositivos	Windows 10 (introduzida na 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v1.0)

Exemplos

O exemplo a seguir mostra o uso de GetTemplateContent para criar o conteúdo para um selo numérico e CreateBadgeUpdaterForApplication para enviar uma atualização de selo numérico para o bloco do aplicativo de chamada.

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);
}

Comentários

Histórico de versão

Versão do Windows	Versão do SDK	Valor adicionado
1607	14393	GetForUser

Métodos

CreateBadgeUpdaterForApplication()	Cria e inicializa uma nova instância do BadgeUpdater, que permite alterar a aparência ou o conteúdo do selo no bloco do aplicativo de chamada.
CreateBadgeUpdaterForApplication(String)	Cria e inicializa uma nova instância do BadgeUpdater para o selo de um bloco de aplicativo especificado, geralmente o bloco de outro aplicativo no pacote. O BadgeUpdater permite alterar a aparência ou o conteúdo desse selo.
CreateBadgeUpdaterForSecondaryTile(String)	Cria e inicializa uma nova instância do BadgeUpdater, que permite alterar a aparência ou o conteúdo de um selo em um bloco secundário. O bloco pode pertencer ao aplicativo de chamada ou a qualquer outro aplicativo no mesmo pacote.
GetForUser(User)	Cria e inicializa um novo BadgeUpdateManagerForUser para o usuário especificado, o que permite alterar a aparência ou o conteúdo do selo em um bloco para um usuário específico.
GetTemplateContent(BadgeTemplateType)	Obtém o conteúdo XML de um dos modelos de selo predefinidos para que você possa personalizá-lo para uma atualização de selo.

Confira também

• Exemplo de blocos e selos do aplicativo
• Diretrizes e lista de verificação de blocos e notificações
• Como limpar um selo
• Como enviar um selo glifo ou numérico em uma notificação local
• Como configurar notificações periódicas para selos
• Como atualizar uma notificação por meio de notificações por push
• Esquema XML de selo
• Visão geral do selo