Condividi tramite


TileUpdateManager Classe

Definizione

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)]
class TileUpdateManager final
/// [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)]
public static class TileUpdateManager
[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

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.

Si applica a

Vedi anche