Partager via


TileUpdateManager Classe

Définition

Crée des objets TileUpdater utilisés pour modifier et mettre à jour les vignettes du menu Démarrer . Cette classe fournit également l’accès au contenu XML des modèles de vignette fournis par le système afin que vous puissiez personnaliser ce contenu pour l’utiliser dans la mise à jour de vos vignettes.

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
Héritage
Object Platform::Object IInspectable TileUpdateManager
Attributs

Configuration requise pour Windows

Famille d’appareils
Windows 10 (introduit dans 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract
Windows.Foundation.UniversalApiContract (introduit dans v1.0)

Exemples

L’exemple suivant montre GetTemplateContent utilisé pour récupérer le contenu XML d’un modèle de vignette et CreateTileUpdaterForApplication pour envoyer la notification à la vignette 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);
}

Remarques

Il s’agit d’une classe d’usine statique qui ne nécessite aucune instanciation.

Historique des versions

Version de Windows Version du SDK Valeur ajoutée
1607 14393 GetForUser

Méthodes

CreateTileUpdaterForApplication()

Crée et initialise une nouvelle instance de TileUpdater, ce qui vous permet de modifier l’apparence de la vignette de l’application appelante.

CreateTileUpdaterForApplication(String)

Crée et initialise une nouvelle instance de TileUpdater pour une vignette qui appartient à une autre application dans le même package que l’application appelante. TileUpdater permet à un développeur de modifier l’apparence de cette vignette.

CreateTileUpdaterForSecondaryTile(String)

Crée et initialise une nouvelle instance de TileUpdater, ce qui vous permet de modifier l’apparence d’une vignette secondaire. La vignette peut appartenir à l’application appelante ou à toute autre application du même package.

GetForUser(User)

Crée et initialise un nouveau TileUpdateManagerForUser pour l’utilisateur spécifié, ce qui vous permet de modifier l’apparence ou le contenu d’une vignette pour un utilisateur spécifique.

GetTemplateContent(TileTemplateType)

Obtient le contenu XML de l’un des modèles de vignette prédéfinis afin que vous puissiez le personnaliser pour une mise à jour de vignette.

Notes

Lorsque cette méthode est appelée sur un système Windows 8, elle retourne un modèle de version 1. Lorsque cette méthode est appelée sur un système Windows 8.1, elle retourne un modèle de version 2. Toutefois, si une application spécifie la compatibilité windows 8 dans son manifeste, cette méthode retourne un modèle de version 1.

S’applique à

Voir aussi