IWidgetProvider.Activate(WidgetContext) Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Notifica al provider di widget che l'host del widget è attualmente interessato a ricevere contenuto aggiornato dal provider.
public:
void Activate(WidgetContext ^ widgetContext);void Activate(WidgetContext const& widgetContext);public void Activate(WidgetContext widgetContext);function activate(widgetContext)Public Sub Activate (widgetContext As WidgetContext)Parametri
- widgetContext
- WidgetContext
Oggetto WidgetContext che identifica il widget attivato e fornisce informazioni di configurazione.
Commenti
Il Deactivate(String) metodo viene chiamato per notificare al provider di widget che l'host del widget non richiede più aggiornamenti del contenuto. Questi due metodi definiscono una finestra in cui l'host del widget è più interessato a visualizzare il contenuto più aggiornato. I provider di widget possono inviare aggiornamenti al widget in qualsiasi momento, ad esempio in risposta a una notifica push, ma come per qualsiasi attività in background, è importante bilanciare la fornitura di contenuto aggiornato con problemi relativi alle risorse come la durata della batteria.
L'attivazione e la disattivazione vengono chiamate per ogni widget. Si noti che l'intervallo di tempo tra Activate e Deactivate può essere ridotto, quindi è consigliabile provare a rendere il percorso del codice di aggiornamento del widget il più rapidamente possibile.
Si noti che quando un widget viene creato per la prima volta, come indicato da una chiamata a CreateWidget(WidgetContext), si trova nello stato attivo.
Gli oggetti passati in questo metodo di callback sono garantiti solo per essere validi all'interno del callback. Non è consigliabile archiviare riferimenti a questi oggetti perché il relativo comportamento all'esterno del contesto del callback non è definito.