IWidgetProvider.Activate(WidgetContext) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Benachrichtigt den Widgetanbieter, dass der Widgethost derzeit daran interessiert ist, aktualisierte Inhalte vom Anbieter zu erhalten.
public:
void Activate(WidgetContext ^ widgetContext);void Activate(WidgetContext const& widgetContext);public void Activate(WidgetContext widgetContext);function activate(widgetContext)Public Sub Activate (widgetContext As WidgetContext)Parameter
- widgetContext
- WidgetContext
Ein WidgetContext Objekt, das das aktivierte Widget identifiziert und Konfigurationsinformationen bereitstellt.
Hinweise
Die String) Methode wird aufgerufen, um den Widgetanbieter zu benachrichtigen, dass der Widgethost keine Inhaltsaktualisierungen mehr anfordert. Diese beiden Methoden definieren ein Fenster, in dem der Widgethost am meisten daran interessiert ist, den up-to-date-Inhalt anzuzeigen. Widget-Anbieter können jederzeit Aktualisierungen an das Widget senden, z. B. als Reaktion auf eine Pushbenachrichtigung, aber wie bei jeder Hintergrundaufgabe ist es wichtig, up-to-Datumsinhalte mit Ressourcenbedenken wie der Akkulaufzeit bereitzustellen.
Aktivieren von und Deaktivieren werden pro Widget aufgerufen. Beachten Sie, dass das Zeitfenster zwischen Aktivieren und Deaktivieren klein sein kann. Daher empfiehlt es sich, den Codepfad des Widgets so schnell wie möglich zu aktualisieren.
Beachten Sie, dass sich beim ersten Erstellen eines Widgets, wie durch einen Aufruf von WidgetContext)angegeben, im aktiven Zustand befindet.
Objekte, die an diese Rückrufmethode übergeben werden, sind nur innerhalb des Rückrufs gültig. Verweise auf diese Objekte sollten nicht gespeichert werden, da ihr Verhalten außerhalb des Kontexts des Rückrufs nicht definiert ist.