Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Windows widget sono contenitori di interfaccia utente di piccole dimensioni che visualizzano il contenuto fornito da un'app Windows o da un'app Web progressiva (PWA). È possibile fornire un modello di scheda adattiva e dati oppure usare un widget Web per visualizzare HTML da un URL. I widget Web usano ancora un payload JSON di Adaptive Card per specificare l'URL del contenuto.
Per un'app desktop in pacchetto, si implementa un provider di widget che risponde alle richieste dall'host del widget e invia gli aggiornamenti tramite WidgetManager. Un PWA usa le definizioni dei widget nel manifesto dell'app Web e gestisce gli eventi del widget nel relativo service worker.
Per una panoramica dell'esperienza dei widget di Windows e indicazioni sulla progettazione per la creazione di widget personalizzati, vedere Widget di Windows.
È attualmente possibile implementare un provider di widget usando un'app desktop Win32 in pacchetto o un'app Web progressiva (PWA). Per ulteriori informazioni:
- Implementare un provider di widget in un'app win32 (C#)
- Implementare un provider di widget in un'app win32 (C++/WinRT)
- Crea widget basati su PWA
- Provider di widget Web
- Personalizzazione dell'intestazione del widget
API e funzionalità del provider di widget desktop
Implementare IWidgetProvider per la creazione, l'eliminazione, l'attivazione, le modifiche del contesto e le azioni dell'utente. L'interfaccia di base rimane obbligatoria quando si aggiungono interfacce facoltative per la personalizzazione o il contenuto Web.
| Capability | API o linee guida | Availability |
|---|---|---|
| Ciclo di vita del widget e aggiornamenti delle schede adattive | IWidgetProvider e WidgetManager | SDK per app di Windows 1.2 |
| Personalizzazione utente | IWidgetProvider2 e l'attributo IsCustomizable del manifesto | SDK per app di Windows 1.4 |
| Contenuto Web, richieste di risorse e messaggistica | Provider di widget Web, IWidgetResourceProvider, IWidgetProviderMessage e WidgetManager.SendMessageToContent | SDK per app di Windows 1.6.3. Controllare anche l'host web-widget e i requisiti regionali. |
| Indicazione di contenuto non ancora personalizzato o utilizzabile | WidgetUpdateRequestOptions.IsPlaceholderContent | SDK per app di Windows 1.6.6 |
| Callback di analisi dei widget | IWidgetProviderAnalytics | La scheda Windows Widgets supporta questi callback a partire da Windows 11 build 26900. Anche altri host devono supportare l'interfaccia; vedere le osservazioni dell'API. |
Le versioni dell'SDK identificano quando le API sono diventate disponibili, non quale versione dovresti installare. Usare una versione stabile attualmente supportata dai canali di rilascio SDK per app di Windows e testare le funzionalità usate sul dispositivo Windows di destinazione e nell'host widget. Per le opzioni di presentazione dell'intestazione, vedere Personalizzare l'area dell'intestazione del widget. L'API del service worker PWA è un percorso di implementazione separato; le interfacce desktop in questa tabella non si applicano a essa.
L'host widget può attivare e rilasciare il provider indipendentemente dalla durata dei widget fissati. Ripristinare lo stato del widget all'avvio del provider e non conservare gli oggetti argomento di callback dopo il ritorno di una callback di IWidgetProvider. Per altre informazioni, vedere le osservazioni di IWidgetProvider.
Per informazioni di riferimento sull'API completa, vedere lo spazio dei nomi Microsoft.Windows.Widgets.Providers.
Per una procedura dettagliata sulle nozioni di base sulla creazione di un widget e sull'implementazione di un provider di widget, guardare l'episodio Tabs vs Spaces "Creare Widgets per Windows 11".
Risorse aggiuntive
Articoli correlati
Collabora con noi su GitHub
L'origine di questo contenuto è disponibile in GitHub, in cui è anche possibile creare ed esaminare i problemi e le richieste pull. Per ulteriori informazioni, vedere la guida per i collaboratori.
