BadgeNotification Classe

Definição

Namespace:

Windows.UI.Notifications

Define o conteúdo, os metadados associados e o tempo de expiração de uma atualização para a sobreposição de selo de um bloco. Um selo pode exibir um número de 1 a 99 ou um glifo status.

public ref class BadgeNotification sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
/// [Windows.Foundation.Metadata.Activatable(Windows.UI.Notifications.IBadgeNotificationFactory, 65536, "Windows.Foundation.UniversalApiContract")]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class BadgeNotification final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
[Windows.Foundation.Metadata.Activatable(typeof(Windows.UI.Notifications.IBadgeNotificationFactory), 65536, "Windows.Foundation.UniversalApiContract")]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class BadgeNotification

function BadgeNotification(content)

Public NotInheritable Class BadgeNotification

Herança

Object Platform::Object IInspectable BadgeNotification

Atributos

ActivatableAttribute 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 código de exemplo a seguir usa o método BadgeNotification para criar uma notificação de selo numérico. Se você usou esse método para definir o valor como "0", ele limparia o selo.

var Notifications = Windows.UI.Notifications;

var badgeXml = Notifications.BadgeUpdateManager.getTemplateContent(Notifications.BadgeTemplateType.badgeNumber);
var badgeAttributes = badgeXml.getElementsByTagName("badge");
badgeAttributes[0].setAttribute("value", "26");

// Create a badge notification from XML
var badgeNotification = new Notifications.badgeNotification(badgeXml);

O código de exemplo a seguir usa o método BadgeNotification para criar uma notificação de selo de glifo. Se você usou esse método para definir o valor como "none", ele limparia o selo.

var Notifications = Windows.UI.Notifications;

var badgeXml = Notifications.BadgeUpdateManager.getTemplateContent(Notifications.BadgeTemplateType.badgeNumber);
var badgeAttributes = badgeXml.getElementsByTagName("badge");
badgeAttributes[0].setAttribute("value", "alert");

// Create a badge notification from XML
var badgeNotification = new Notifications.badgeNotification(badgeXml);

Construtores

BadgeNotification(XmlDocument)

Cria e inicializa uma nova instância do BadgeNotification.

Propriedades

Content	Obtém o XML que define o valor ou o glifo usado como o selo do bloco.
ExpirationTime	Obtém ou define a hora em que o Windows removerá o selo do bloco. Por padrão, as notificações de selo local não expiram e as notificações por push, periódicas e agendadas expiram após três dias. É uma prática recomendada definir explicitamente um tempo de expiração para evitar conteúdo obsoleto.

Confira também

• Exemplo de blocos e selos do aplicativo
• Visão geral do selo
• 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