Compartilhar via


IWidgetProvider.Activate(WidgetContext) Método

Definição

Notifica o provedor de widget de que o host do widget está interessado em receber conteúdo atualizado do provedor.

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

Parâmetros

widgetContext
WidgetContext

Um WidgetContext objeto que identifica o widget que está sendo ativado e fornece informações de configuração.

Comentários

O Deactivate(String) método é chamado para notificar o provedor de widget de que o host widget não está mais solicitando atualizações de conteúdo. Esses dois métodos definem uma janela na qual o host do widget prefere mostrar o conteúdo mais atualizado. Os provedores de widget podem enviar atualizações para o widget a qualquer momento, como em resposta a uma notificação por push, mas, como em qualquer tarefa em segundo plano, é importante equilibrar o fornecimento de conteúdo atualizado com questões de recursos, como a duração da bateria.

Activate e Deactivate são chamados por widget. Observe que a janela de tempo entre Activate e Deactivate pode ser pequena, portanto, é recomendável que você tente acelerar ao máximo o caminho do código de atualização do widget.

Observe que quando um widget é criado pela primeira vez, conforme indicado por uma chamada para CreateWidget(WidgetContext), ele está no estado ativo.

Os objetos passados para esse método de retorno de chamada só têm garantia de serem válidos dentro do retorno de chamada. Você não deve armazenar referências a esses objetos porque o comportamento fora do contexto do retorno de chamada é indefinido.

Aplica-se a