IWidgetProvider Interfaccia
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Questa interfaccia viene implementata dai provider di widget Windows per ricevere callback dall'host del widget per gli eventi di durata del 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- Attributi
Commenti
Questa interfaccia deve essere implementata come server COM out-of-process. La durata di un provider di widget è indipendente dalla durata dei widget; Un provider di widget può essere attivato e rilasciato da Gestione widget in qualsiasi momento. Più provider per la stessa app provider verranno eseguiti in un processo condiviso. I provider di app del provider diversi verranno eseguiti in processi separati.
Gli oggetti passati nei callback dell'interfaccia IWidgetProvider sono garantiti validi solo nel callback. Non è consigliabile archiviare riferimenti a questi oggetti perché il relativo comportamento all'esterno del contesto del callback non è definito.
Per una panoramica dei widget Windows, vedere Panoramica dei widget. Per informazioni sullo sviluppo di un provider di widget, vedere Provider di servizi widget.
Metodi
| Nome | Descrizione |
|---|---|
| Activate(WidgetContext) |
Notifica al provider di widget che l'host del widget è attualmente interessato a ricevere contenuto aggiornato dal provider. |
| CreateWidget(WidgetContext) |
Notifica al provider di widget che è stato creato un nuovo widget, ad esempio quando un utente aggiunge un widget a un host widget. |
| Deactivate(String) |
Notifica al provider di widget che l'host del widget non richiede più attivamente contenuto aggiornato dal provider. |
| DeleteWidget(String, String) |
Notifica al provider di widget che uno dei widget supportati è stato eliminato, ad esempio quando un utente rimuove un widget da un host widget. |
| OnActionInvoked(WidgetActionInvokedArgs) |
Chiamato quando viene richiamata un'azione su un widget, ad esempio l'utente che fa clic su un pulsante. |
| OnWidgetContextChanged(WidgetContextChangedArgs) |
Chiamato quando cambia la configurazione del widget all'interno dell'host del widget. |