TileUpdateManager Clase

Definición

Espacio de nombres:

Windows.UI.Notifications

Crea objetos TileUpdater usados para cambiar y actualizar iconos del menú Inicio . Esta clase también proporciona acceso al contenido XML de las plantillas de icono proporcionadas por el sistema para que pueda personalizar ese contenido para su uso en la actualización de los iconos.

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

Herencia

Object Platform::Object IInspectable TileUpdateManager

Atributos

ContractVersionAttribute ThreadingAttribute MarshalingBehaviorAttribute

Requisitos de Windows

Familia de dispositivos	Windows 10 (se introdujo en la versión 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract	Windows.Foundation.UniversalApiContract (se introdujo en la versión v1.0)

Ejemplos

En el ejemplo siguiente se muestra GetTemplateContent usado para recuperar el contenido XML de una plantilla de icono y CreateTileUpdaterForApplication para enviar la notificación al icono de la aplicación.

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

Comentarios

Se trata de una clase de fábrica estática y no requiere ninguna creación de instancias.

Historial de versiones

Versión de Windows	Versión del SDK	Valor agregado
1607	14393	GetForUser

Métodos

CreateTileUpdaterForApplication()	Crea e inicializa una nueva instancia de TileUpdater, que permite cambiar la apariencia del icono de la aplicación que realiza la llamada.
CreateTileUpdaterForApplication(String)	Crea e inicializa una nueva instancia de TileUpdater para un icono que pertenece a otra aplicación en el mismo paquete que la aplicación que realiza la llamada. TileUpdater permite a un desarrollador cambiar la apariencia de ese icono.
CreateTileUpdaterForSecondaryTile(String)	Crea e inicializa una nueva instancia de TileUpdater, que permite cambiar la apariencia de un icono secundario. El icono puede pertenecer a la aplicación que llama o a cualquier otra aplicación del mismo paquete.
GetForUser(User)	Crea e inicializa un nuevo TileUpdateManagerForUser para el usuario especificado, lo que le permite cambiar la apariencia o el contenido de un icono para un usuario específico.
GetTemplateContent(TileTemplateType)	Obtiene el contenido XML de una de las plantillas de icono predefinidas para que pueda personalizarlo para una actualización de mosaico. Nota Cuando se llama a este método en un sistema Windows 8, devuelve una plantilla de la versión 1. Cuando se llama a este método en un sistema Windows 8.1, devuelve una plantilla de la versión 2. Sin embargo, si una aplicación especifica la compatibilidad de Windows 8 en su manifiesto, este método devuelve una plantilla de versión 1.

Consulte también

• Ejemplo de iconos y distintivos de la aplicación
• Inicio rápido: Envío de una actualización de icono
• Información general sobre las notificaciones de iconos y iconos
• Catálogo de plantillas de icono
• Directrices y lista de comprobación para iconos
• Programación de una notificación de icono
• Cómo configurar notificaciones periódicas para iconos
• Esquema XML de iconos