TileUpdater Classe

Definição

Namespace:

Windows.UI.Notifications

Altera o conteúdo do bloco específico ao qual o atualizador está associado.

public ref class TileUpdater sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class TileUpdater final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class TileUpdater

Public NotInheritable Class TileUpdater

Herança

Object Platform::Object IInspectable TileUpdater

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 Update usado para enviar uma notificação para o bloco do aplicativo.

function sendTileTextNotification() {
    var Notifications = Windows.UI.Notifications;

    // Get an XML DOM version of a specific template by using getTemplateContent.
    var tileXml = Notifications.TileUpdateManager.getTemplateContent(Notifications.TileTemplateType.tileWide310x150Text03);

    // You will need to look at the template documentation to know how many text fields a particular template has.
    // Get the text attribute for this template and fill it in.
    var tileAttributes = tileXml.getElementsByTagName("text");
    tileAttributes[0].appendChild(tileXml.createTextNode("Hello World!"));

    // Create the notification from the XML.
    var tileNotification = new Notifications.TileNotification(tileXml);

    // Send the notification to the calling app's tile.
    Notifications.TileUpdateManager.createTileUpdaterForApplication().update(tileNotification);
}

A linha de código a seguir usa EnableNotificationQueue para habilitar a fila de notificação para o bloco do aplicativo de chamada.

Windows.UI.Notifications.TileUpdateManager.createTileUpdaterForApplication().enableNotificationQueue(true);

O exemplo a seguir mostra o uso do método RemoveFromSchedule .

var notifier = Notifications.TileUpdateManager.createTileUpdaterForApplication();
var scheduled = notifier.getScheduledTileNotifications();

for (var i = 0, len = scheduled.length; i < len; i++) {

    // The itemId value is the unique ScheduledTileNotification.Id assigned to the 
    // notification when it was created.
    if (scheduled[i].id === itemId) {
        notifier.removeFromSchedule(scheduled[i]);
    }
}

Comentários

Para obter uma instância desse objeto, chame o método TileUpdateManager.CreateTileUpdaterForApplication ou TileUpdateManager.CreateTileUpdaterForSecondaryTile .

Quando ele é criado, TileUpdater é 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.

Propriedades

Setting

Obtém um valor que especifica se um bloco pode ser atualizado por meio de notificações.

Métodos

AddToSchedule(ScheduledTileNotification)	Adiciona um ScheduledTileNotification ao agendamento.
Clear()	Remove todas as atualizações e faz com que o bloco exiba seu conteúdo padrão, conforme declarado no manifesto do aplicativo.
EnableNotificationQueue(Boolean)	Permite que o bloco enfileira até cinco notificações. Isso habilita a fila de notificação em todos os tamanhos de bloco.
EnableNotificationQueueForSquare150x150(Boolean)	Permite que o bloco enfileira até cinco notificações no bloco médio.
EnableNotificationQueueForSquare310x310(Boolean)	Permite que o bloco enfileira até cinco notificações no bloco grande.
EnableNotificationQueueForWide310x150(Boolean)	Permite que o bloco enfileira até cinco notificações no bloco largo.
GetScheduledTileNotifications()	Recupera uma lista de atualizações agendadas para o bloco.
RemoveFromSchedule(ScheduledTileNotification)	Remove uma atualização de bloco futura do agendamento.
StartPeriodicUpdate(Uri, DateTime, PeriodicUpdateRecurrence)	Inicia uma série de atualizações cronometradas para o bloco ao qual o atualizador está associado. O conteúdo da atualização é recuperado de um URI (Uniform Resource Identifier) especificado. Atualizações começar em um horário especificado.
StartPeriodicUpdate(Uri, PeriodicUpdateRecurrence)	Inicia uma série de alterações de conteúdo temporizado para o bloco ao qual o atualizador está associado, começando imediatamente.
StartPeriodicUpdateBatch(IIterable<Uri>, DateTime, PeriodicUpdateRecurrence)	Inicia uma série de atualizações cronometradas que circulam no bloco ao qual o atualizador está associado. O conteúdo da atualização é recuperado de uma matriz de URI (Uniform Resource Identifier) especificado com atualizações começando em um horário especificado e atualizações subsequentes ocorrendo no intervalo periódico posteriormente. Observação Para usar esse recurso, primeiro você deve habilitar a fila de notificação do bloco chamando EnableNotificationQueue.
StartPeriodicUpdateBatch(IIterable<Uri>, PeriodicUpdateRecurrence)	Inicia uma série de atualizações cronometradas que circulam no bloco ao qual o atualizador está associado. O conteúdo da atualização é recuperado de uma matriz de URI (Uniform Resource Identifier) especificado, a primeira atualização ocorrendo imediatamente e as atualizações subsequentes ocorrendo no intervalo periódico posteriormente. Observação Para usar esse recurso, primeiro você deve habilitar a fila de notificação do bloco chamando EnableNotificationQueue.
StopPeriodicUpdate()	Cancela a série atual de atualizações cronometradas para o bloco ao qual o atualizador está associado.
Update(TileNotification)	Aplica uma alteração no conteúdo ou aparência ao bloco.