binding (schema del riquadro)

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 Windows accodare 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 oppure ignorando la stringa di query e restituisce l'immagine come specificato senza la stringa di query. Questa stringa di query specifica la scalabilità, l'impostazione del contrasto e la lingua. 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=standardms-lang&=en-us"

boolean No false
baseUri

URI di base predefinito combinato con URI relativi negli attributi di origine dell'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 di riquadri di grandi dimensioni.

stringa No
Fallback

Modello da usare se il nome del modello primario non viene riconosciuto dal destinatario, per l'uso con Windows 8 compatibilità. Questo valore è il Windows 8 del valore nell'attributo del modello. I nuovi modelli introdotti dopo Windows 8 non hanno un fallback.

tileTemplateNameV1 (vedere Note) No nessuno
lang

Impostazioni locali di destinazione del payload XML, specificate come tag di lingua BCP-47 , ad esempio "en-US" o "fr-FR". Le impostazioni locali specificate qui eseguono l'override di tale impostazione nell'oggetto visivo, ma possono essere sostitute da tale impostazione nel testo. Se questo valore è una stringa letterale, questo attributo viene impostato per impostazione predefinita sulla lingua dell'interfaccia utente dell'utente. Se questo valore è un riferimento a una stringa, per impostazione predefinita questo attributo viene impostato sulle impostazioni locali scelte Windows Runtime per la risoluzione della stringa. Vedere Osservazioni per quando questo valore non è specificato.

stringa No nessuno
Modello

Uno dei modelli forniti su 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 Note) Nessuno

 

Elementi figlio

Elemento figlio Descrizione
image

Specifica un'immagine usata nel modello di riquadro. L'immagine fornita deve corrispondere ai requisiti di dimensioni e forma per il modello o l'immagine specifica 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 del 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. Questi sono i nomi Windows 8 modello. 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 del 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, in cui [Resource Management System](/previous-versions/windows/apps/jj552947(v=win.10)) determina che l'app verrà eseguita in base al profilo della lingua corrente.
  • Altrimenti, la lingua del nome visualizzato nel riquadro come risolto dal Windows Runtime
  • In altro modo, la lingua dell'interfaccia utente della shell (lingua 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, in cui [Resource Management System](/previous-versions/windows/apps/jj552947(v=win.10)) determina che l'app verrà eseguita in base al profilo della lingua corrente.
  • Altrimenti, la lingua del nome visualizzato nel riquadro come risolto dal Windows Runtime
  • In altro modo, la lingua dell'interfaccia utente della shell (lingua MUI)
Elementi di testo con contenuto ms-resource
  • Se impostato in modo esplicito, usare visual.lang o binding.lang e il linguaggio esplicito viene anteposto all'elenco di lingue [ResourceContext](/previous-versions/windows/apps/jj552947(v=win.10)#resourcecontext) di Resource Management System usato per risolvere la stringa
  • Altrimenti [ResourceContext](/previous-versions/windows/apps/jj552947(v=win.10)#resourcecontext) usato come inizializzato con il profilo della lingua 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 dei caratteri per l'interfaccia utente.

Immagine ms-appx:///
  • Se impostata in modo esplicito, usare visual.lang o binding.lang. Il linguaggio esplicito viene anteposto all'elenco di lingue [ResourceContext](/previous-versions/windows/apps/jj552947(v=win.10)#resourcecontext) del sistema di gestione delle risorse usato per risolvere la stringa
  • Altrimenti [ResourceContext](/previous-versions/windows/apps/jj552947(v=win.10)#resourcecontext) usato come inizializzato con il profilo della lingua dell'utente
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, in cui [Resource Management System](/previous-versions/windows/apps/jj552947(v=win.10)) determina che l'app verrà eseguita in base al profilo della lingua corrente.
  • Altrimenti, la lingua del nome visualizzato nel riquadro come risolto da Windows Runtime (potrebbe non essere impostata se il nome è indipendente dalla lingua)
  • In altro modo, la lingua dell'interfaccia utente della shell (lingua MUI)

Questo linguaggio è incluso nella stringa di query se addImageQuery è true.

 

Requisiti

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