TileUpdater Clase

Definición

Espacio de nombres:

Windows.UI.Notifications

Cambia el contenido del icono específico al que está enlazado el actualizador.

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

Herencia

Object Platform::Object IInspectable TileUpdater

Atributos

ContractVersionAttribute 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 Update usado para enviar una 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);
}

La siguiente línea de código usa EnableNotificationQueue para habilitar la cola de notificaciones para el icono de la aplicación que realiza la llamada.

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

En el ejemplo siguiente se muestra el uso del 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]);
    }
}

Comentarios

Para obtener una instancia de este objeto, llame al método TileUpdateManager.CreateTileUpdaterForApplication o TileUpdateManager.CreateTileUpdaterForSecondaryTile .

Cuando se crea, TileUpdater se enlaza a una aplicación específica o a un icono secundario, por lo que los métodos de esta clase solo afectan al icono único al que está enlazada la instancia de objeto.

Propiedades

Setting

Obtiene un valor que especifica si un icono se puede actualizar a través de notificaciones.

Métodos

AddToSchedule(ScheduledTileNotification)	Agrega scheduledTileNotification a la programación.
Clear()	Quita todas las actualizaciones y hace que el icono muestre su contenido predeterminado como se declara en el manifiesto de la aplicación.
EnableNotificationQueue(Boolean)	Habilita el icono para poner en cola hasta cinco notificaciones. Esto habilita la cola de notificaciones en todos los tamaños de icono.
EnableNotificationQueueForSquare150x150(Boolean)	Habilita el icono para poner en cola hasta cinco notificaciones en el icono medio.
EnableNotificationQueueForSquare310x310(Boolean)	Permite que el icono poner en cola hasta cinco notificaciones en el icono grande.
EnableNotificationQueueForWide310x150(Boolean)	Permite que el icono poner en cola hasta cinco notificaciones en el icono ancho.
GetScheduledTileNotifications()	Recupera una lista de actualizaciones programadas en el icono.
RemoveFromSchedule(ScheduledTileNotification)	Quita una próxima actualización del icono de la programación.
StartPeriodicUpdate(Uri, DateTime, PeriodicUpdateRecurrence)	Comienza una serie de actualizaciones con tiempo para el icono al que está enlazado el actualizador. El contenido de actualización se recupera de un identificador uniforme de recursos (URI) especificado. Novedades comienzan en un momento especificado.
StartPeriodicUpdate(Uri, PeriodicUpdateRecurrence)	Comienza una serie de cambios de contenido con tiempo para el icono al que está enlazado el actualizador, comenzando inmediatamente.
StartPeriodicUpdateBatch(IIterable<Uri>, DateTime, PeriodicUpdateRecurrence)	Comienza una serie de actualizaciones con tiempo a las que se enlaza el ciclo del icono al que está enlazado el actualizador. El contenido de la actualización se recupera de una matriz de identificador uniforme de recursos (URI) especificado con actualizaciones a partir de un momento especificado y las actualizaciones posteriores que se producen en el intervalo periódico a partir de entonces. Nota Para usar esta característica, primero debe habilitar la cola de notificaciones del icono llamando a EnableNotificationQueue.
StartPeriodicUpdateBatch(IIterable<Uri>, PeriodicUpdateRecurrence)	Comienza una serie de actualizaciones con tiempo a las que se enlaza el ciclo del icono al que está enlazado el actualizador. El contenido de la actualización se recupera de una matriz de identificador uniforme de recursos (URI) especificado, la primera actualización que se produce inmediatamente y las actualizaciones posteriores se producen en el intervalo periódico a partir de entonces. Nota Para usar esta característica, primero debe habilitar la cola de notificaciones del icono llamando a EnableNotificationQueue.
StopPeriodicUpdate()	Cancela la serie actual de actualizaciones con tiempo para el icono al que está enlazado el actualizador.
Update(TileNotification)	Aplica un cambio en el contenido o la apariencia al icono.