binding (schema riquadro)

Articolo
02/01/2024

Specifica il modello di riquadro. Ogni notifica deve includere un elemento di associazione per ogni dimensione del riquadro supportata.

Gerarchia degli elementi

<Piastrelle>

<Visual>: <Associazione>

Sintassi

<binding template       = tileTemplateNameV2
         fallback?      = tileTemplateNameV1
         lang?          = string
         baseUri?       = anyURI
         branding?      = "none" | "logo" | "name"
         addImageQuery? = boolean
         contentId?     = string >

  <!-- Child elements -->
  ( image
  | text
  )*

</binding>

Chiave

?facoltativo (zero o uno) facoltativo (zero o più) *

Attributi ed elementi

Attributi

Attributo	Descrizione	Tipo di dati	Obbligatoria	Valore predefinito
addImageQuery	Impostare su true per consentire a Windows di aggiungere una stringa di query all'URI dell'immagine fornito nella notifica del riquadro. Usare questo attributo se il server ospita immagini e può gestire le stringhe di query, recuperando una variante di immagine in base alle stringhe di query o ignorando la stringa di query e restituendo l'immagine come specificato senza la stringa di query. Questa stringa di query specifica la scalabilità, l'impostazione di contrasto e il linguaggio; ad esempio, un valore di "www.website.com/images/hello.png" incluso nella notifica diventa "www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us"	boolean	No	false
baseUri	URI di base predefinito combinato con URI relativi negli attributi dell'origine immagine.	anyURI	No	ms-appx:///
Branding	Modulo che il riquadro deve usare per visualizzare il marchio dell'app.	Questo attributo può avere uno dei valori seguenti: Nessuno Logo name	No	Logo
contentId	Impostare su una stringa definita dal mittente che identifica in modo univoco il contenuto della notifica. Ciò impedisce i duplicati nella situazione in cui un modello di riquadro di grandi dimensioni visualizza le ultime tre notifiche a riquadri wide.	string	No
Fallback	Modello da usare se il nome del modello primario non viene riconosciuto dal destinatario, per l'uso con compatibilità Windows 8. Questo valore è il nome Windows 8 del valore nell'attributo modello. Nuovi modelli introdotti dopo Windows 8 non hanno un fallback.	tileTemplateNameV1 (vedere Osservazioni)	No	nessuno
Lang	Le impostazioni locali di destinazione del payload XML, specificate come tag linguistici BCP-47 , ad esempio "en-US" o "fr-FR". Le impostazioni locali specificate qui eseguono l'override di tale elemento nell'oggetto visivo, ma possono essere sostituite da tale elemento nel testo. Se questo valore è una stringa letterale, questo attributo viene predefinito per la lingua dell'interfaccia utente dell'utente. Se questo valore è un riferimento stringa, questo attributo viene predefinito per le impostazioni locali scelte da Windows Runtime nella risoluzione della stringa. Vedere Osservazioni per quando questo valore non è specificato.	string	No	nessuno
Modello	Uno dei modelli forniti in cui basare il riquadro. In genere, uno sviluppatore deve fornire sia un formato quadrato che un formato wide, ognuno come elemento di associazione separato. Le voci valide sono membri dell'enumerazione tileTemplateType .	tileTemplateNameV2 (vedere Osservazioni)	Sì	Nessuno

Elementi figlio

Elemento figlio	Descrizione
image	Specifica un'immagine usata nel modello di riquadro. L'immagine fornita deve corrispondere ai requisiti di dimensione e forma per il modello o l'immagine specifici all'interno di tale modello.
text	Specifica il testo usato nel modello di riquadro.

Elementi padre

Elemento padre	Descrizione
Visual	Contiene più elementi figlio di associazione , ognuno dei quali definisce un riquadro.

Commenti

Il valore tileTemplateNameV2 usato nell'attributo modello può essere uno dei valori stringa seguenti. Per informazioni dettagliate su ogni modello, vedere Catalogo dei modelli di riquadro.

TileSquare150x150Block
TileSquare150x150Image
TileSquare150x150PeekImageAndText01
TileSquare150x150PeekImageAndText02
TileSquare150x150PeekImageAndText03
TileSquare150x150PeekImageAndText04
TileSquare150x150Text01
TileSquare150x150Text02
TileSquare150x150Text03
TileSquare150x150Text04
TileSquare310x310BlockAndText01
TileSquare310x310BlockAndText02
TileSquare310x310Image
TileSquare310x310ImageAndText01
TileSquare310x310ImageAndText02
TileSquare310x310ImageAndTextOverlay01
TileSquare310x310ImageAndTextOverlay02
TileSquare310x310ImageAndTextOverlay03
TileSquare310x310ImageCollection
TileSquare310x310ImageCollectionAndText01
TileSquare310x310ImageCollectionAndText02
TileSquare310x310SmallImagesAndTextList01
TileSquare310x310SmallImagesAndTextList02
TileSquare310x310SmallImagesAndTextList03
TileSquare310x310SmallImagesAndTextList04
TileSquare310x310Text01
TileSquare310x310Text02
TileSquare310x310Text03
TileSquare310x310Text04
TileSquare310x310Text05
TileSquare310x310Text06
TileSquare310x310Text07
TileSquare310x310Text08
TileSquare310x310TextList01
TileSquare310x310TextList02
TileSquare310x310TextList03
TileWide310x150BlockAndText01
TileWide310x150BlockAndText02
TileWide310x150Image
TileWide310x150ImageAndText01
TileWide310x150ImageAndText02
TileWide310x150ImageCollection
TileWide310x150PeekImage01
TileWide310x150PeekImage02
TileWide310x150PeekImage03
TileWide310x150PeekImage04
TileWide310x150PeekImage05
TileWide310x150PeekImage06
TileWide310x150PeekImageAndText01
TileWide310x150PeekImageAndText02
TileWide310x150PeekImageCollection01
TileWide310x150PeekImageCollection02
TileWide310x150PeekImageCollection03
TileWide310x150PeekImageCollection04
TileWide310x150PeekImageCollection05
TileWide310x150PeekImageCollection06
TileWide310x150SmallImageAndText01
TileWide310x150SmallImageAndText02
TileWide310x150SmallImageAndText03
TileWide310x150SmallImageAndText04
TileWide310x150SmallImageAndText05
TileWide310x150Text01
TileWide310x150Text02
TileWide310x150Text03
TileWide310x150Text04
TileWide310x150Text05
TileWide310x150Text06
TileWide310x150Text07
TileWide310x150Text08
TileWide310x150Text09
TileWide310x150Text10
TileWide310x150Text11

Il valore tileTemplateNameV1 usato nell'attributo di fallback può essere uno dei valori stringa seguenti. Si tratta dei nomi dei modelli Windows 8. Per informazioni dettagliate su ogni modello, vedere Catalogo dei modelli di riquadro.

TileSquareBlock
TileSquareImage
TileSquarePeekImageAndText01
TileSquarePeekImageAndText02
TileSquarePeekImageAndText03
TileSquarePeekImageAndText04
TileSquareText01
TileSquareText02
TileSquareText03
TileSquareText04
TileWideBlockAndText01
TileWideBlockAndText02
TileWideImage
TileWideImageAndText01
TileWideImageAndText02
TileWideImageCollection
TileWidePeekImage01
TileWidePeekImage02
TileWidePeekImage03
TileWidePeekImage04
TileWidePeekImage05
TileWidePeekImage06
TileWidePeekImageAndText01
TileWidePeekImageAndText02
TileWidePeekImageCollection01
TileWidePeekImageCollection02
TileWidePeekImageCollection03
TileWidePeekImageCollection04
TileWidePeekImageCollection05
TileWidePeekImageCollection06
TileWideSmallImageAndText01
TileWideSmallImageAndText02
TileWideSmallImageAndText03
TileWideSmallImageAndText04
TileWideSmallImageAndText05
TileWideText01
TileWideText02
TileWideText03
TileWideText04
TileWideText05
TileWideText06
TileWideText07
TileWideText08
TileWideText09
TileWideText10
TileWideText11

Nella tabella seguente viene illustrato il modo in cui il sistema risponde quando lang non è specificato.

Per...	Risposta di sistema
Lingua per la notifica	Se impostato in modo esplicito, usare visual.lang o binding.lang In caso contrario, l'impostazione della lingua specifica dell'app (la lingua, se presente, che [Sistema di gestione risorse](/previous-versions/windows/apps/jj552947(v=win.10)) determina che l'app verrà eseguita in base al profilo linguistico corrente) In caso contrario, la lingua del nome visualizzato nel riquadro viene risolta da Windows Runtime In caso contrario, il linguaggio dell'interfaccia utente della shell (linguaggio MUI) Questo linguaggio influisce principalmente sul layout delle colonne nei modelli che presentano colonne.
Elementi di testo con testo letterale	Se impostato in modo esplicito, usare visual.lang o binding.lang In caso contrario, l'impostazione della lingua specifica dell'app (la lingua, se presente, che [Sistema di gestione risorse](/previous-versions/windows/apps/jj552947(v=win.10)) determina che l'app verrà eseguita in base al profilo linguistico corrente) In caso contrario, la lingua del nome visualizzato nel riquadro viene risolta da Windows Runtime In caso contrario, il linguaggio dell'interfaccia utente della shell (linguaggio MUI)
Elementi di testo con contenuto ms-resource	Se impostato in modo esplicito, usare visual.lang o binding.lang e la lingua esplicita viene anteposta all'elenco di lingue [ResourceContext](/previous-versions/windows/apps/jj552947(v=win.10)#resourcecontext) usato per risolvere la stringa Else the [ResourceContext](/previous-versions/windows/apps/jj552947(v=win.10)#resourcecontext) usato come inizializzato con il profilo linguistico dell'utente Dopo la risoluzione della stringa, la lingua per la stringa risolta viene assegnata all'elemento di testo. Questa lingua modella l'allineamento del testo (LTR e RTL) e la selezione del tipo di carattere per l'interfaccia utente.
ms-appx:/// image	Se impostato in modo esplicito, usare visual.lang o binding.lang, la lingua esplicita viene anteposta all'elenco di lingue [ResourceContext](/previous-versions/windows/apps/jj552947(v=win.10)#resourcecontext) usato per risolvere la stringa Else the [ResourceContext](/previous-versions/windows/apps/jj552947(v=win.10)#resourcecontext) us used as initialized with the user's language profile
Immagini cloud	Se impostato in modo esplicito, usare visual.lang o binding.lang In caso contrario, l'impostazione della lingua specifica dell'app (la lingua, se presente, che [Sistema di gestione risorse](/previous-versions/windows/apps/jj552947(v=win.10)) determina che l'app verrà eseguita nel profilo linguistico corrente) In caso contrario, la lingua del nome visualizzato nel riquadro viene risolta da Windows Runtime (potrebbe non essere impostata se il nome è indipendente dalla lingua) In caso contrario, il linguaggio dell'interfaccia utente della shell (linguaggio MUI) Questo linguaggio è incluso nella stringa di query se addImageQuery è true.

Requisiti

	Valore
Namespace	`http://schemas.microsoft.com/notifications/2012/tile.xsd`