TileUpdateManager Classe

Définition

Espace de noms:

Windows.UI.Notifications

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)]
/// [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

Héritage

Object Platform::Object IInspectable TileUpdateManager

Attributs

ContractVersionAttribute ThreadingAttribute MarshalingBehaviorAttribute

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.

Voir aussi

• Exemple de vignettes et de badges d’application
• Démarrage rapide : Envoi d’une mise à jour de vignette
• Vue d’ensemble des notifications de vignette et de vignette
• Catalogue de modèles de vignettes
• Recommandations et liste de contrôle pour les vignettes
• Comment planifier une notification par vignette
• Comment configurer des notifications périodiques pour des vignettes
• Schéma XML des vignettes