Personalizzare l'area della testata del widget

Nella versione più recente le app che implementano i widget di Windows possono personalizzare l'intestazione visualizzata per il widget nella scheda Widget, eseguendo l'override della presentazione predefinita. La personalizzazione dell'intestazione viene implementata nel payload della scheda adattiva passata al sistema operativo dal provider di widget, quindi i passaggi sono uguali indipendentemente dalla lingua in cui viene implementato il provider di widget. Per una procedura dettagliata sulla creazione di un provider di widget, vedere Implementare un provider di widget in un'app Windows C# o Implementare un provider di widget in un'app win32 (C++/WinRT).

Intestazione predefinita

Per impostazione predefinita, l'intestazione del widget mostra il nome visualizzato e l'icona specificata nel file manifesto dell'app. Il nome visualizzato viene specificato con l'attributo DisplayName dell'elemento Definition e l'icona viene specificata con un elemento Icon in ThemeResources. Per altre informazioni sul formato di file manifesto dell'app widget, vedere Formato XML del manifesto del pacchetto del provider di widget.

L'esempio seguente mostra una parte del payload JSON della scheda adattiva per un widget che usa la presentazione predefinita. Nelle sezioni seguenti verranno forniti esempi che modificano questo modello per eseguire l'override dell'intestazione predefinita.

{ 
    "type": "AdaptiveCard", 
    "$schema": "http://adaptivecards.io/schemas/adaptive-card.json", 
    "version": "1.6", 
    "body": [
        ...
    ] 
  } 

Eseguire l'override della stringa del nome visualizzato

È possibile eseguire l'override del valore specificato nell'elemento DisplayName nel manifesto dell'app aggiungendo un header campo a con il nuovo nome visualizzato nel payload JSON prima di inviarlo all'host del widget.

Nell'esempio seguente viene dimostrato come sovrascrivere la stringa del nome visualizzato.

{ 
    "type": "AdaptiveCard", 
    "$schema": "http://adaptivecards.io/schemas/adaptive-card.json", 
    "version": "1.6", 
    "body": [
        ...
    ] ,
    "header": "Redmond Weather"
  } 

Eseguire l'override della stringa e dell'icona del nome visualizzato

Per eseguire l'override sia della stringa del nome visualizzato che dell'icona specificata nel manifesto dell'app, aggiungere un header oggetto con campi per text e iconUrl.

Nell'esempio seguente viene illustrato come sovrascrivere la stringa del nome visualizzato e l'icona.

{ 
    "type": "AdaptiveCard", 
    "$schema": "http://adaptivecards.io/schemas/adaptive-card.json", 
    "version": "1.6", 
    "body": [
        ...
    ] ,
    "header": { 
         "text": "Redmond weather", 
         "iconUrl": "https://contoso.com/weatherimage.png" 
      } 
  } 

Impostare l'intestazione come vuota

Alcuni fornitori di widget potrebbero voler consentire la loro esperienza utente di espandersi nella regione del titolo del widget, anche se quest'area non è interattiva. Per questo scenario, è possibile impostare l'intestazione come vuota impostando il valore di header su null. Si noti che l'esperienza utente nell'intestazione non è cliccabile dall'utente.

Nell'esempio seguente viene illustrata l'impostazione di un'intestazione vuota.

{ 
    "type": "AdaptiveCard", 
    "$schema": "http://adaptivecards.io/schemas/adaptive-card.json", 
    "version": "1.6", 
    "body": [
        ...
    ] ,
    "header": null
}