Integrare con il selettore widget

Nella versione corrente l'unico host widget è la scheda Widget incorporata in Windows 11. La scheda Widget visualizza i widget e ne gestisce il layout sulla scheda. Fornisce anche una selezione widget che consente all'utente di selezionare i widget disponibili visibili nella scheda. Questo articolo descrive gli asset necessari per integrare correttamente un widget nel selettore di widget.

Immagine dello screenshot del widget

Ogni widget deve fornire un'immagine di esempio visualizzata come anteprima nella selezione dei widget quando il widget è selezionato. Lo screenshot è specificato dal fornitore del widget nel manifesto del pacchetto per l'app. Per informazioni tecniche su come specificare un file di immagine da usare per lo screenshot del widget, vedere Implementare un provider di widget in un'app win32 e Formato XML del manifesto del pacchetto del provider widget.

Lo screenshot seguente illustra il posizionamento dell'immagine screenshot all'interno della selezione widget.

Requisiti dell'immagine dello screenshot

Per offrire un'esperienza utente coerente, gli screenshot dei widget per il selettore di widget devono seguire le linee guida seguenti.

• Lo screenshot deve visualizzare la versione di dimensioni medie del widget.
• L'immagine deve avere una larghezza di 300 pixel e un'altezza di 304 pixel.
• L'immagine deve avere angoli trasparenti e arrotondati.

Il manifesto del provider di widget include tre diversi elementi screenshot che è possibile impostare. Lo screenshot di primo livello è obbligatorio e verrà usato come impostazione predefinita dalla selezione widget. Le sezioni LightMode e DarkMode del manifesto sono opzionali e le permettono di specificare screenshot separati per il suo widget in modalità chiara e scura. Se si specifica uno o entrambi questi screenshot facoltativi, la selezione widget userà quella che corrisponde al tema corrente del dispositivo. Se non si specifica un'immagine specifica per il tema corrente, la selezione widget userà invece lo screenshot di primo livello predefinito.

È possibile fornire screenshot del widget per più impostazioni locali. Le impostazioni locali per ogni screenshot sono specificate con il percorso dell'asset relativo al pacchetto dell'app.

• Creare una directory nel progetto di packaging per gli asset di immagine. Ad esempio: "Assets".
• Gli asset di fallback o indipendenti dalla lingua possono essere inseriti direttamente in questa cartella. Ad esempio: "Assets/Screenshot.png"
• Gli asset specifici della lingua possono essere inseriti nelle sottodirectory chiamate in base ai locali a cui si applicano. Ad esempio:
  • Gli asset "inglese (Stati Uniti)" devono essere inseriti in una sottodirectory denominata "en-us": "Assets/en-us/Screenshot.png"
  • Gli asset "Francese (Francia)" devono essere inseriti in una sottodirectory denominata "fr-fr": "Assets/fr-fr/Screenshot.png"
• Fare riferimento a queste immagini in appxmanifest usando lo schema URI ms-appx:. Ad esempio: Screenshot="ms-appx:Assets\Screenshot.png"
• Se non si include un'immagine per una data località, verrà usata l'immagine predefinita nella directory radice.

Il caricatore di risorse sceglierà automaticamente l'asset appropriato per la lingua da visualizzare. Per ulteriori informazioni, vedere Caricare immagini e asset personalizzati per scala, tema, contrasto elevato e altro.

Di seguito è riportato un esempio di immagine di screenshot del widget.