語言

IWidgetProvider.Deactivate(String) 方法

定義

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

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

被停用的元件唯一識別碼。 Widget ID 值由 WidgetManager 動態產生。 從小工具建立的那一刻起,小工具的 ID 保持不變,直到小工具被刪除為止。 Widget ID 是所有 Widget 及其提供者間唯一的值。

備註

Activate 方法被呼叫用來通知小工具提供者,小工具主機有興趣從提供者那裡接收更新內容。 這兩種方法定義了一個時間範圍,讓 widget 主機可以最有效地顯示最新的內容。 Widget 提供者可以隨時將更新傳送至 Widget,例如回應推送通知,但如同任何背景工作一樣,重要的是要平衡提供最新內容與資源考量如電池壽命等。

適用於