IWidgetProvider Interface
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.
Essa interface é implementada por provedores de Widget do Windows para receber retornos de chamada do host widget para eventos de tempo de vida do widget.
public interface class IWidgetProvider/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.Windows.Widgets.WidgetContract, 65536)]
/// [Windows.Foundation.Metadata.Guid(1549235404, 29344, 17709, 185, 237, 7, 92, 13, 210, 94, 237)]
struct IWidgetProvider[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.Windows.Widgets.WidgetContract), 65536)]
[Windows.Foundation.Metadata.Guid(1549235404, 29344, 17709, 185, 237, 7, 92, 13, 210, 94, 237)]
public interface IWidgetProviderPublic Interface IWidgetProvider- Atributos
Comentários
Essa interface será implementada como um servidor COM fora do processo. O tempo de vida de um provedor de widget é independente dos tempos de vida de seus widgets; um provedor de widget pode ser ativado e liberado pelo anager widgetm a qualquer momento. Vários provedores para o mesmo aplicativo provedor serão executados em um processo compartilhado. Provedores de diferentes aplicativos provedores serão executados em processos separados.
Os objetos passados aos métodos de retorno de chamada da interface IWidgetProvider 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.
Para obter uma visão geral dos Widgets do Windows, consulte Visão geral de Widgets. Para obter informações sobre como desenvolver um provedor de widget, consulte Provedores de serviços widget.
Métodos
| Activate(WidgetContext) |
Notifica o provedor de widget de que o host do widget está interessado em receber conteúdo atualizado do provedor. |
| CreateWidget(WidgetContext) |
Notifica o provedor de widget de que um novo widget foi criado, por exemplo, quando um usuário adiciona um widget a um host widget. |
| Deactivate(String) |
Notifica o provedor de widget de que o host do widget não está mais solicitando ativamente o conteúdo atualizado do provedor. |
| DeleteWidget(String, String) |
Notifica o provedor de widget de que um dos widgets compatíveis com ele foi excluído, por exemplo, quando um usuário remove um widget de um host widget. |
| OnActionInvoked(WidgetActionInvokedArgs) |
Chamado quando uma ação é invocada em um widget, como o usuário clicando em um botão. |
| OnWidgetContextChanged(WidgetContextChangedArgs) |
Chamado quando a configuração do widget dentro do host do widget é alterada. |