oggetto visivo (schema riquadro)

  • Articolo

Contiene più elementi figlio di associazione , ognuno dei quali definisce un riquadro.

Gerarchia degli elementi

<Piastrelle>
<Visual>

Sintassi

<visual version?       = integer
        lang?          = string
        baseUri?       = anyURI
        branding?      = "none" | "logo" | "name"
        addImageQuery? = boolean
        contentId?     = string >

  <!-- Child elements -->
  binding+

</visual>

Chiave

?facoltativo (zero o uno) obbligatorio (uno 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 nessuno
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 nessuno
Lang

Le impostazioni locali di destinazione del payload XML, specificate come tag linguistici BCP-47 , ad esempio "en-US" o "fr-FR". Questa impostazione locale viene sostituita da qualsiasi impostazione locale specificata nell'associazione o 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
version

La versione dello schema XML del riquadro è stata sviluppata per questo particolare payload. Può avere due valori, 1 o 2. La versione 1 richiede un payload valido nello schema Windows 8. La versione 2 riconosce i nuovi modelli di riquadro di grandi dimensioni, i nuovi nomi di modello Windows 8.1 per i modelli esistenti e l'attributo di fallback dell'elemento di associazione.

 numero intero No 1

 

Elementi figlio

Elemento figlio Descrizione
Associazione

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

 

Elementi padre

Elemento padre Descrizione
Piastrelle

Elemento riquadro di base che contiene un singolo elemento visivo .

 

Commenti

Nella tabella seguente viene illustrato come il sistema risponde quando lang non viene 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 il [sistema di gestione risorse](/versioni precedenti/windows/apps/jj552947(v=win.10)) determina che l'app verrà eseguita in base al profilo linguistico corrente)
  • Diversamente la lingua del nome visualizzato nel riquadro come risolto da Windows Runtime
  • Altro linguaggio dell'interfaccia utente della Shell (linguaggio MUI)

Questo linguaggio influisce principalmente sul layout delle colonne nei modelli che dispongono di 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 il [sistema di gestione risorse](/versioni precedenti/windows/apps/jj552947(v=win.10)) determina che l'app verrà eseguita in base al profilo linguistico corrente)
  • Diversamente la lingua del nome visualizzato nel riquadro come risolto da Windows Runtime
  • Altro 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 il linguaggio esplicito viene preceduto dall'elenco delle lingue [ResourceContext](/previous-version/windows/apps/jj552947(v=win.10)#resourcecontext) usato per risolvere la stringa
  • Else the [ResourceContext](/previous-version/windows/apps/jj552947(v=win.10)#resourcecontext) usato come inizializzato con il profilo linguistico dell'utente

Dopo aver risolto la stringa, la lingua per la stringa risolta viene assegnata all'elemento di testo. Questa lingua forma l'allineamento del testo (LTR e RTL) e la selezione dei tipi di carattere per l'interfaccia utente.
ms-appx:/// image
  • Se impostato in modo esplicito, usare visual.lang o binding.lang, il linguaggio esplicito viene preceduto dall'elenco delle lingue [ResourceContext](/previous-version/windows/apps/jj552947(v=win.10)#resourcecontext) usato per risolvere la stringa
  • Else the [ResourceContext](/previous-version/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 del linguaggio specifica dell'app (lingua, se presente, che il [sistema di gestione risorse](/versioni precedenti/windows/apps/jj552947(v=win.10)) determina che l'app verrà eseguita in base al profilo linguistico corrente)
  • Altrimenti la lingua del nome visualizzato nel riquadro come risolto da Windows Runtime (potrebbe non essere impostata se il nome è indipendente dalla lingua)
  • Altro 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