TileUpdateManager Classe

Definição

Namespace:

Windows.UI.Notifications

Cria objetos TileUpdater usados para alterar e atualizar blocos de menu Iniciar . Essa classe também fornece acesso ao conteúdo XML dos modelos de bloco fornecidos pelo sistema para que você possa personalizar esse conteúdo para uso na atualização dos blocos.

public ref class TileUpdateManager 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 TileUpdateManager 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 TileUpdateManager

Public Class TileUpdateManager

Herança

Object Platform::Object IInspectable TileUpdateManager

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 GetTemplateContent usado para recuperar o conteúdo XML de um modelo de bloco e CreateTileUpdaterForApplication para enviar a 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);
}

Comentários

Essa é uma classe de fábrica estática e não requer instanciação.

Histórico de versão

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

Métodos

CreateTileUpdaterForApplication()	Cria e inicializa uma nova instância do TileUpdater, que permite alterar a aparência do bloco do aplicativo de chamada.
CreateTileUpdaterForApplication(String)	Cria e inicializa uma nova instância do TileUpdater para um bloco que pertence a outro aplicativo no mesmo pacote que o aplicativo de chamada. O TileUpdater permite que um desenvolvedor altere a aparência desse bloco.
CreateTileUpdaterForSecondaryTile(String)	Cria e inicializa uma nova instância do TileUpdater, que permite alterar a aparência de 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 TileUpdateManagerForUser para o usuário especificado, o que permite alterar a aparência ou o conteúdo de um bloco para um usuário específico.
GetTemplateContent(TileTemplateType)	Obtém o conteúdo XML de um dos modelos de bloco predefinidos para que você possa personalizá-lo para uma atualização de bloco. Observação Quando esse método é chamado em um sistema Windows 8, ele retorna um modelo de versão 1. Quando esse método é chamado em um sistema Windows 8.1, ele retorna um modelo de versão 2. No entanto, se um aplicativo especificar a compatibilidade do Windows 8 em seu manifesto, esse método retornará um modelo de versão 1.

Confira também

• Exemplo de blocos e selos do aplicativo
• Início Rápido: Enviando uma atualização de bloco
• Visão geral da notificação de bloco e bloco
• O catálogo de modelos de bloco
• Diretrizes e lista de verificação para blocos
• Como agendar uma notificação de bloco
• Como configurar notificações periódicas para blocos
• Esquema XML de blocos