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物件，識別正在啟動的 Widget 並提供組態資訊。

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

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

請注意，當第一次建立小工具時，如呼叫 CreateWidget(WidgetContext) 所指出，其處於作用中狀態。

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