TileUpdateManager Classe

Definizione

Spazio dei nomi:

Windows.UI.Notifications

Crea oggetti TileUpdater usati per modificare e aggiornare i riquadri del menu Start . Questa classe fornisce anche l'accesso al contenuto XML dei modelli di riquadro forniti dal sistema in modo che sia possibile personalizzare tale contenuto da usare nell'aggiornamento dei riquadri.

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

Ereditarietà

Object Platform::Object IInspectable TileUpdateManager

Attributi

ContractVersionAttribute ThreadingAttribute 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 GetTemplateContent usato per recuperare il contenuto XML di un modello di riquadro e CreateTileUpdaterForApplication per inviare la 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);
}

Commenti

Si tratta di una classe factory statica e non richiede alcuna istanza.

Cronologia delle versioni

Versione di Windows	Versione dell'SDK	Valore aggiunto
1607	14393	GetForUser

Metodi

CreateTileUpdaterForApplication()	Crea e inizializza una nuova istanza di TileUpdater, che consente di modificare l'aspetto del riquadro dell'app chiamante.
CreateTileUpdaterForApplication(String)	Crea e inizializza una nuova istanza di TileUpdater per un riquadro appartenente a un'altra app nello stesso pacchetto dell'app chiamante. TileUpdater consente a uno sviluppatore di modificare l'aspetto di tale riquadro.
CreateTileUpdaterForSecondaryTile(String)	Crea e inizializza una nuova istanza di TileUpdater, che consente di modificare l'aspetto di un riquadro secondario. Il riquadro può appartenere all'app chiamante o a qualsiasi altra app nello stesso pacchetto.
GetForUser(User)	Crea e inizializza un nuovo TileUpdateManagerForUser per l'utente specificato, che consente di modificare l'aspetto o il contenuto di un riquadro per un utente specifico.
GetTemplateContent(TileTemplateType)	Ottiene il contenuto XML di uno dei modelli di riquadro predefiniti in modo che sia possibile personalizzarlo per un aggiornamento del riquadro. Nota Quando questo metodo viene chiamato in un sistema Windows 8, restituisce un modello versione 1. Quando questo metodo viene chiamato in un sistema Windows 8.1, restituisce un modello versione 2. Tuttavia, se un'app specifica la compatibilità di Windows 8 nel manifesto, questo metodo restituisce un modello versione 1.

Vedi anche

• Esempio di riquadri e badge dell'app
• Avvio rapido: Invio di un aggiornamento del riquadro
• Panoramica della notifica riquadro e riquadro
• Catalogo dei modelli di riquadro
• Linee guida ed elenco di controllo per i riquadri
• Come pianificare una notifica del riquadro
• Come configurare notifiche periodiche per i riquadri
• Riquadri XML Schema