TileUpdater Class

Modifie le contenu de la mosaïque spécifique à laquelle le programme de mise à jour est lié.

Syntaxe


public ref class TileUpdater sealed 

Attributs

[Muse()]
[Version(0x06020000)]

Membres

TileUpdaterClasse possède ces types de membres :

Méthodes

The TileUpdater Classe a les méthodes suivantes. Avec C#, Visual Basic et C++, elle hérite également des méthodes de Object Classe.

MéthodeDescription
AddToSchedule Adds a ScheduledTileNotification to the schedule.
Clear Removes all updates and causes the tile to display its default content as declared in the app's manifest.
EnableNotificationQueue Enables the tile to queue up to five notifications. This enables the notification queue on all tile sizes.
EnableNotificationQueueForSquare150x150 Enables the tile to queue up to five notifications on the medium tile.
EnableNotificationQueueForSquare310x310 Enables the tile to queue up to five notifications on the large tile.
EnableNotificationQueueForWide310x150 Enables the tile to queue up to five notifications on the wide tile.
GetScheduledTileNotifications Retrieves a list of scheduled updates to the tile.
RemoveFromSchedule Removes an upcoming tile update from the schedule.
StartPeriodicUpdate(Uri, DateTime, PeriodicUpdateRecurrence) Begins a series of timed updates for the tile that the updater is bound to. Update content is retrieved from a specified Uniform Resource Identifier (URI). Updates begin at a specified time.
StartPeriodicUpdate(Uri, PeriodicUpdateRecurrence) Begins a series of timed content changes for the tile that the updater is bound to, beginning immediately.
StartPeriodicUpdateBatch(IIterable(Uri), DateTime, PeriodicUpdateRecurrence) Begins a series of timed updates that cycle on the tile that the updater is bound to. Update content is retrieved from an array of specified Uniform Resource Identifier (URI) with updates beginning at a specified time and subsequent updates occurring at the periodic interval thereafter.
StartPeriodicUpdateBatch(IIterable(Uri), PeriodicUpdateRecurrence) Begins a series of timed updates that cycle on the tile that the updater is bound to. Update content is retrieved from an array of specified Uniform Resource Identifier (URI), the first update happening immediately and subsequent updates occurring at the periodic interval thereafter.
StopPeriodicUpdate Cancels the current series of timed updates for the tile that the updater is bound to.
Update Applies a change in content or appearance to the tile.

 

Propriétés

Le TileUpdaterClasse a les propriétés suivantes.

PropriétéType d'accèsDescription

Setting

En lecture seuleGets a value that specifies whether a tile can be updated through notifications.

 

Remarques

Pour obtenir une instance de cet objet, appelez la méthode TileUpdateManager.CreateTileUpdaterForApplication ou TileUpdateManager.CreateTileUpdaterForSecondaryTile.

Lorsqu'elle est créée, TileUpdater est liée à une application ou à une mosaïque secondaire spécifique. Les méthodes de cette classe affectent donc uniquement la seule mosaïque à laquelle l'instance de l'objet est liée.

Exemples

L'exemple suivant illustre la méthode Update utilisée pour envoyer une notification à la mosaïque de l'application.



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 ligne de code suivante utilise EnableNotificationQueue pour activer la file d'attente de notification pour la mosaïque de l'application appelante.



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

L'exemple suivant illustre l'utilisation de la méthode 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]);
    }
}

Conditions requises

Client minimal pris en charge

Windows 8 [Applications Windows Store uniquement]

Serveur minimal pris en charge

Windows Server 2012 [Applications Windows Store uniquement]

Espace de noms

Windows.UI.Notifications
Windows::UI::Notifications [C++]

Métadonnées

Windows.winmd

 

 

Afficher:
© 2014 Microsoft