IWidgetProvider.Deactivate(String) 方法

定義

命名空間:

Microsoft.Windows.Widgets.Providers

通知小工具提供者，小工具主機不再主動向提供者要求更新的內容。

public:
 void Deactivate(Platform::String ^ widgetId);

void Deactivate(winrt::hstring const& widgetId);

public void Deactivate(string widgetId);

function deactivate(widgetId)

Public Sub Deactivate (widgetId As String)

參數

widgetId

String

Platform::String

winrt::hstring

要停用之小工具的唯一識別碼。 小工具識別碼值是由 動態產生 WidgetManager 。 小工具識別碼在建立小工具時維持不變，直到小工具刪除為止。 小工具識別碼是所有小工具與所有小工具提供者的唯一值。

備註

系統會 Activate(WidgetContext) 呼叫 方法，通知小工具提供者小工具主機有興趣從提供者接收更新的內容。 這兩種方法會定義一個視窗，其中小工具主機最有興趣顯示最新的內容。 小工具提供者可以隨時將更新傳送至小工具，例如回應推播通知，但如同任何背景工作一樣，請務必平衡提供最新內容與電池使用時間等資源考慮。