BadgeUpdater Classe

Definição

Namespace:

Windows.UI.Notifications

Atualizações uma sobreposição de selo no bloco específico ao qual o atualizador está associado.

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

Herança

Object Platform::Object IInspectable BadgeUpdater

Atributos

ContractVersionAttribute 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 Update 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

Para obter uma instância desse objeto, chame o método BadgeUpdateManager.CreateBadgeUpdaterForApplication ou BadgeUpdateManager.CreateBadgeUpdaterForSecondaryTile .

Quando ele é criado, BadgeUpdater é associado a um aplicativo específico ou bloco secundário, portanto, os métodos dessa classe afetam apenas o único bloco ao qual a instância do objeto está associada.

Métodos

Clear()	Remove o selo do bloco ao qual o atualizador está associado.
StartPeriodicUpdate(Uri, DateTime, PeriodicUpdateRecurrence)	Inicia uma série de atualizações cronometradas para o selo de um recurso da Web ao qual o atualizador está associado. Atualizações começar em um momento especificado. Observe que somente recursos da Web (http/https) são permitidos em uma atualização periódica.
StartPeriodicUpdate(Uri, PeriodicUpdateRecurrence)	Inicia uma série de atualizações cronometradas para o selo de um recurso da Web ao qual o atualizador está associado, começando imediatamente. Observe que somente recursos da Web (http/https) são permitidos em uma atualização periódica.
StopPeriodicUpdate()	Cancela a série atual de atualizações cronometradas para o selo ao qual o atualizador está associado.
Update(BadgeNotification)	Aplica uma alteração ao glifo ou número do 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