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 di 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 viene 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 widgetm anager in qualsiasi momento. Più provider per la stessa app provider verranno eseguiti in un processo condiviso. I provider di app provider diversi verranno eseguiti in processi separati.
Gli oggetti passati nei metodi di callback dell'interfaccia IWidgetProvider sono garantiti solo per essere validi all'interno del 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 di Windows, vedere Panoramica dei widget. Per informazioni sullo sviluppo di un provider di widget, vedere Provider di servizi widget.
Metodi
| 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 il 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. |