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 小工具的概述,請參見小工具總覽。 關於如何開發小工具提供者的資訊,請參見 小工具服務提供者。
方法
| 名稱 | Description |
|---|---|
| Activate(WidgetContext) |
通知小工具提供者,小工具主機目前有興趣接收該提供者的最新內容。 |
| CreateWidget(WidgetContext) |
例如,當使用者將小工具加入小工具主機時,通知小工具提供者已建立新小工具。 |
| Deactivate(String) |
通知小工具提供者小工具主機不再主動向提供者請求更新內容。 |
| DeleteWidget(String, String) |
例如,當使用者從小工具主機移除小工具時,通知小工具提供者其支援的某個小工具已被刪除。 |
| OnActionInvoked(WidgetActionInvokedArgs) |
當元件被觸發動作時,例如使用者點擊按鈕時,會被呼叫。 |
| OnWidgetContextChanged(WidgetContextChangedArgs) |
當元件在元件主機內的設定變更時呼叫。 |