IWidgetProvider.Activate(WidgetContext) 方法

定义

命名空间:

Microsoft.Windows.Widgets.Providers

通知小组件提供程序，小组件主机当前有兴趣从提供程序接收更新的内容。

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)调用 方法以通知小组件提供程序小组件主机不再请求内容更新。 这两种方法定义了一个窗口，在该窗口中，小组件主机最感兴趣的是显示最新内容。 小组件提供程序可以随时向小组件发送更新，例如响应推送通知，但与任何后台任务一样，请务必在提供最新内容的同时，兼顾资源问题（如电池使用时间）。

Activate 和 Deactivate 按小组件调用。 请注意，Activate 和 Deactivate 之间的时间窗口可能很小，因此建议尽量加快小组件更新代码路径。

请注意，首次创建小组件时，如调用 CreateWidget(WidgetContext)所示，该小组件处于活动状态。

传入此回调方法的对象仅保证在回调中有效。 不应存储对这些对象的引用，因为它们在回调上下文之外的行为未定义。