oggetto visivo (schema riquadro)

Articolo
02/01/2024

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`

Condividi tramite