IWidgetProvider.Activate(WidgetContext) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Avertit le fournisseur de widgets que l’hôte du widget souhaite actuellement recevoir du contenu mis à jour du fournisseur.
public:
void Activate(WidgetContext ^ widgetContext);void Activate(WidgetContext const& widgetContext);public void Activate(WidgetContext widgetContext);function activate(widgetContext)Public Sub Activate (widgetContext As WidgetContext)Paramètres
- widgetContext
- WidgetContext
Objet WidgetContext qui identifie le widget en cours d’activation et fournit des informations de configuration.
Remarques
La Deactivate(String) méthode est appelée pour informer le fournisseur de widgets que l’hôte du widget ne demande plus de mises à jour de contenu. Ces deux méthodes définissent une fenêtre dans laquelle l’hôte du widget est le plus intéressé par l’affichage du contenu le plus à jour. Les fournisseurs de widgets peuvent envoyer des mises à jour au widget à tout moment, par exemple en réponse à une notification Push, mais comme pour toute tâche en arrière-plan, il est important de trouver un équilibre entre fournir du contenu à jour et les questions liées aux ressources, comme l’autonomie de la batterie.
Activate et Deactivate sont appelés pour chaque widget. Notez que la fenêtre de temps entre Activate et Deactivate peut être petite. Il est donc recommandé d’essayer de rendre le chemin du code de mise à jour de votre widget aussi rapide que possible.
Notez que lorsqu’un widget est créé pour la première fois, comme indiqué par un appel à CreateWidget(WidgetContext), il est dans l’état actif.
La validité des objets passés dans cette méthode de rappel est garantie uniquement dans le rappel. Vous ne devez pas stocker les références à ces objets, car leur comportement en dehors du contexte du rappel n’est pas défini.