TileUpdater Classe

Definizione

Spazio dei nomi:

Windows.UI.Notifications

Modifica il contenuto del riquadro specifico a cui è associato l'aggiornamento.

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

Ereditarietà

Object Platform::Object IInspectable TileUpdater

Attributi

ContractVersionAttribute MarshalingBehaviorAttribute

Requisiti Windows

Famiglia di dispositivi	Windows 10 (è stato introdotto in 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract	Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)

Esempio

Nell'esempio seguente viene illustrato Update usato per inviare una notifica al riquadro dell'app.

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 riga di codice seguente usa EnableNotificationQueue per abilitare la coda di notifica per il riquadro dell'app chiamante.

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

Nell'esempio seguente viene illustrato l'uso del metodo 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]);
    }
}

Commenti

Per ottenere un'istanza di questo oggetto, chiamare il metodo TileUpdateManager.CreateTileUpdaterForApplication o TileUpdateManager.CreateTileUpdaterForSecondaryTile .

Al momento della creazione, TileUpdater è associato a un'app o a un riquadro secondario specifico, pertanto i metodi di questa classe influiscono solo sul singolo riquadro a cui è associata l'istanza dell'oggetto.

Proprietà

Setting

Ottiene un valore che specifica se un riquadro può essere aggiornato tramite notifiche.

Metodi

AddToSchedule(ScheduledTileNotification)	Aggiunge un oggetto ScheduledTileNotification alla pianificazione.
Clear()	Rimuove tutti gli aggiornamenti e causa la visualizzazione del relativo contenuto predefinito come dichiarato nel manifesto dell'app.
EnableNotificationQueue(Boolean)	Consente al riquadro di accodare fino a cinque notifiche. In questo modo viene attivata la coda di notifica in tutte le dimensioni del riquadro.
EnableNotificationQueueForSquare150x150(Boolean)	Consente al riquadro di accodare fino a cinque notifiche nel riquadro medio.
EnableNotificationQueueForSquare310x310(Boolean)	Consente al riquadro di accodare fino a cinque notifiche nel riquadro di grandi dimensioni.
EnableNotificationQueueForWide310x150(Boolean)	Consente al riquadro di accodare fino a cinque notifiche nel riquadro wide.
GetScheduledTileNotifications()	Recupera un elenco di aggiornamenti pianificati nel riquadro.
RemoveFromSchedule(ScheduledTileNotification)	Rimuove un aggiornamento del riquadro successivo dalla pianificazione.
StartPeriodicUpdate(Uri, DateTime, PeriodicUpdateRecurrence)	Inizia una serie di aggiornamenti temporali per il riquadro a cui è associato l'aggiornamento. Il contenuto dell'aggiornamento viene recuperato da un URI (Uniform Resource Identifier) specificato. Aggiornamenti iniziare a un'ora specificata.
StartPeriodicUpdate(Uri, PeriodicUpdateRecurrence)	Inizia una serie di modifiche apportate al contenuto timed per il riquadro a cui è associato l'aggiornamento, iniziando immediatamente.
StartPeriodicUpdateBatch(IIterable<Uri>, DateTime, PeriodicUpdateRecurrence)	Inizia una serie di aggiornamenti temporali a cui viene eseguito il ciclo nel riquadro a cui è associato l'aggiornamento. Il contenuto dell'aggiornamento viene recuperato da una matrice di URI (Uniform Resource Identifier) specificati con aggiornamenti a partire da un momento specificato e gli aggiornamenti successivi che si verificano a intervalli periodici. Nota Per usare questa funzionalità, è prima necessario abilitare la coda di notifica del riquadro chiamando EnableNotificationQueue.
StartPeriodicUpdateBatch(IIterable<Uri>, PeriodicUpdateRecurrence)	Inizia una serie di aggiornamenti temporali a cui viene eseguito il ciclo nel riquadro a cui è associato l'aggiornamento. Il contenuto dell'aggiornamento viene recuperato da una matrice di URI (Uniform Resource Identifier), il primo aggiornamento che si verifica immediatamente e gli aggiornamenti successivi che si verificano a intervalli periodici. Nota Per usare questa funzionalità, è prima necessario abilitare la coda di notifica del riquadro chiamando EnableNotificationQueue.
StopPeriodicUpdate()	Annulla la serie corrente di aggiornamenti temporali per il riquadro a cui è associato l'aggiornamento.
Update(TileNotification)	Applica una modifica del contenuto o dell'aspetto al riquadro.