IWidgetProvider 接口
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
此接口由 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) |
当小组件主机中小组件的配置发生更改时调用。 |