IWidgetProvider.Activate(WidgetContext) 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
通知小工具提供者,小工具主機目前有興趣接收該提供者的最新內容。
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 表示,該元件處於活躍狀態。
傳遞到此回調方法的物件僅保證在回調內有效。 您不應儲存這些物件的參考,因為它們在回呼函式之外的行為是未定的。