IWidgetProvider.Activate(WidgetContext) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Notifica o provedor de widget de que o host do widget está atualmente 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 objeto WidgetContext que identifica o widget que está sendo ativado e fornece informações de configuração.
Comentários
O método Deactivate é chamado para notificar o provedor de widget de que o host do 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, ele está no estado ativo.
Os objetos passados para esse método de retorno de chamada só têm a 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.