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 物件，可識別要啟動的小工具並提供組態資訊。

呼叫 String）方法，以通知小工具提供者小工具主機不再要求內容更新。這兩種方法會定義小工具主機最感興趣的視窗，以顯示最 up-to日期內容。小工具提供者可以隨時將更新傳送至小工具，例如回應推播通知，但如同任何背景工作一樣，請務必平衡提供 up-to日期內容與電池使用時間等資源考慮。

啟用和停用會根據每個小工具呼叫。請注意，Activate 與 Deactivate 之間的時間範圍可能很小，因此建議您嘗試儘快讓小工具更新程式代碼路徑。

請注意，當小工具第一次建立時，如呼叫 WidgetContext）所指示，它處於使用中狀態。

傳入這個回呼方法的物件只會保證在回呼內有效。您不應該儲存這些對象的參考，因為它們在回呼內容之外的行為未定義。