IWidgetProvider 接口

定义

此接口由 Windows 小组件提供程序实现,用于从小组件主机接收小组件生存期事件的回调。

public interface class IWidgetProvider
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.Windows.Widgets.WidgetContract, 65536)]
/// [Windows.Foundation.Metadata.Guid(1549235404, 29344, 17709, 185, 237, 7, 92, 13, 210, 94, 237)]
struct IWidgetProvider
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.Windows.Widgets.WidgetContract), 65536)]
[Windows.Foundation.Metadata.Guid(1549235404, 29344, 17709, 185, 237, 7, 92, 13, 210, 94, 237)]
public interface IWidgetProvider
Public Interface IWidgetProvider
属性

注解

此接口实现为进程外 COM 服务器。 小组件提供程序的生存期与其小组件的生存期无关;小组件提供程序可以随时由小组件分析器激活和释放。 同一提供程序应用的多个提供程序将在共享进程中运行。 来自不同提供程序应用的提供程序将在单独的进程中运行。

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

有关 Windows 小组件的概述,请参阅 小组件概述。 有关开发小组件提供程序的信息,请参阅 小组件服务提供程序

方法

Activate(WidgetContext)

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

CreateWidget(WidgetContext)

通知小组件提供程序已创建新小组件,例如,当用户将小组件添加到小组件主机时。

Deactivate(String)

通知小组件提供程序,小组件主机不再主动从提供程序请求更新的内容。

DeleteWidget(String, String)

通知小组件提供程序它支持的小组件之一已被删除,例如,当用户从小组件主机中删除小组件时。

OnActionInvoked(WidgetActionInvokedArgs)

在对小组件(例如用户单击按钮)调用操作时调用。

OnWidgetContextChanged(WidgetContextChangedArgs)

当小组件主机中小组件的配置发生更改时调用。

适用于