IWidgetProvider.Activate(WidgetContext) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
ウィジェット ホストがプロバイダーから更新されたコンテンツを受信することに現在関心があることをウィジェット プロバイダーに通知します。
public:
void Activate(WidgetContext ^ widgetContext);void Activate(WidgetContext const& widgetContext);public void Activate(WidgetContext widgetContext);function activate(widgetContext)Public Sub Activate (widgetContext As WidgetContext)パラメーター
- widgetContext
- WidgetContext
WidgetContextアクティブ化されているウィジェットを識別し、構成情報を提供する オブジェクト。
注釈
Deactivate(String)ウィジェット ホストがコンテンツの更新を要求しなくなったことをウィジェット プロバイダーに通知するために、 メソッドが呼び出されます。 これら 2 つのメソッドでは、ウィジェット ホストが最新の内容を表示することに最も関心を持っているウィンドウが定義されています。 ウィジェット プロバイダーは、プッシュ通知への応答など、いつでもウィジェットに更新を送信できますが、バックグラウンド タスクと同様に、最新の内容を提供することと、バッテリーの寿命などのリソースに関する配慮との、バランスを取することが重要です。
Activate と Deactivate は、ウィジェットごとに呼び出されます。 Activate と Deactivate の間の間隔が短い場合があるため、ウィジェットの更新コード パスの時間をできる限り短縮することをお勧めします。
への呼び出しで示されているように、ウィジェットが最初に CreateWidget(WidgetContext)作成されたときは、アクティブな状態であることに注意してください。
このコールバック メソッドに渡されるオブジェクトは、コールバック内でのみ有効であることが保証されます。 コールバックのコンテキストの外部での動作は定義されていないため、これらのオブジェクトへの参照は保存しないでください。