語言

IWidgetProvider.Activate(WidgetContext) 方法

定義

通知小工具提供者,小工具主機目前有興趣接收該提供者的最新內容。

public:
 void Activate(WidgetContext ^ widgetContext);
void Activate(WidgetContext const& widgetContext);
public void Activate(WidgetContext widgetContext);
function activate(widgetContext)
Public Sub Activate (widgetContext As WidgetContext)

參數

widgetContext
WidgetContext

一個 WidgetContext 物件,用來識別被啟用的小工具並提供設定資訊。

備註

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

會針對每個小工具分別呼叫 Activate 和 Deactivate。 請注意,Activate 和 Deactivate 之間的時間範圍可能很小,因此建議您盡量讓小工具更新程式碼路徑執行得越快越好。

請注意,當 widget 首次建立時,根據呼叫 CreateWidget 表示,該元件處於活躍狀態。

傳遞到此回調方法的物件僅保證在回調內有效。 您不應儲存這些物件的參考,因為它們在回呼函式之外的行為是未定的。

適用於