Condividi tramite

Schema del contenuto del riquadro

  • Articolo

Nota

I riquadri vive sono una funzionalità di Windows 10 non supportata nelle versioni successive di Windows. Per le nuove app, è consigliabile seguire le indicazioni correnti per le icone dell'app.

Di seguito vengono descritti tutte le proprietà e gli elementi all'interno del contenuto del riquadro.

Se si preferisce usare codice XML non elaborato anziché la libreria notifiche, vedere XML Schema.

TileContent

TileContent è l'oggetto di primo livello che descrive il contenuto della notifica di un riquadro, inclusi gli oggetti visivi.

Proprietà Type Obbligatorio Descrizione
Oggetto visivo Avviso popupVisual true Descrive la parte visiva della notifica del riquadro.

TileVisual

La parte visiva dei riquadri contiene le specifiche visive per tutte le dimensioni dei riquadri e altre proprietà correlate all'oggetto visivo.

Proprietà Type Obbligatorio Descrizione
TileSmall TileBinding false Specificare un'associazione di piccole dimensioni facoltativa per specificare il contenuto per le dimensioni ridotte del riquadro.
TileMedium TileBinding false Specificare un'associazione di medie dimensioni facoltativa per specificare il contenuto per le dimensioni medie del riquadro.
TileWide TileBinding false Specificare un'associazione di grandi dimensioni facoltativa per specificare il contenuto per le dimensioni grandi del riquadro.
TileLarge TileBinding false Specificare un'associazione di molto grandi dimensioni facoltativa per specificare il contenuto per le dimensioni molto grandi del riquadro.
Personalizzazione TileBranding false Modulo che il riquadro deve usare per visualizzare il marchio dell'app. Per impostazione predefinita, eredita la personalizzazione dal riquadro predefinito.
DisplayName string false Stringa facoltativa per eseguire l'override del nome visualizzato del riquadro durante la visualizzazione di questa notifica.
Argomenti string false Novità dell'aggiornamento dell'anniversario: dati definiti dall'app che vengono passati all'app tramite la proprietà TileActivatedInfo in LaunchActivatedEventArgs quando l'utente avvia l'app dal riquadro animato. In questo modo è possibile sapere quali notifiche di riquadro l'utente ha visto quando ha toccato il riquadro animato. Nei dispositivi senza l'aggiornamento dell'anniversario, questo verrà semplicemente ignorato.
LockDetailedStatus1 string false Se si specifica questa opzione, è necessario specificare anche un'associazione TileWide. Questa è la prima riga di testo che verrà visualizzata nella schermata di blocco se l'utente ha selezionato il riquadro come app di stato dettagliata.
LockDetailedStatus2 string false Se si specifica questa opzione, è necessario specificare anche un'associazione TileWide. Questa è la seconda riga di testo che verrà visualizzata nella schermata di blocco se l'utente ha selezionato il riquadro come app di stato dettagliata.
LockDetailedStatus3 string false Se si specifica questa opzione, è necessario specificare anche un'associazione TileWide. Questa è la terza riga di testo che verrà visualizzata nella schermata di blocco se l'utente ha selezionato il riquadro come app di stato dettagliata.
BaseUri URI false URL di base predefinito combinato con URL relativi negli attributi dell'origine dell'immagine.
AddImageQuery bool? false Impostare su "true" per consentire a Windows di aggiungere una stringa di query all'URL dell'immagine fornito nella notifica di tipo avviso popup. 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, il valore "www.website.com/images/hello.png" specificato nella notifica diventa "www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us"
Lingua string false Impostazioni locali di destinazione del payload visivo quando si usano risorse localizzate, specificate come tag di lingua BCP-47, ad esempio "en-US" o "fr-FR". Queste impostazioni locali vengono sostituite da tutte le impostazioni locali specificate nell'associazione o nel testo. Se non specificato, verranno invece usate le impostazioni locali di sistema.

TileBinding

L'oggetto binding contiene il contenuto visivo per una dimensione specifica del riquadro.

Proprietà Type Obbligatorio Descrizione
Contenuto ITileBindingContent false Contenuto visivo da visualizzare nel riquadro. Uno di TileBindingContentAdaptive, TileBindingContentIconic, TileBindingContentContact, TileBindingContent Persone o TileBindingContent Foto.
Personalizzazione TileBranding false Modulo che il riquadro deve usare per visualizzare il marchio dell'app. Per impostazione predefinita, eredita la personalizzazione dal riquadro predefinito.
DisplayName string false Stringa facoltativa per eseguire l'override del nome visualizzato del riquadro per questa dimensione del riquadro.
Argomenti string false Novità dell'aggiornamento dell'anniversario: dati definiti dall'app che vengono passati all'app tramite la proprietà TileActivatedInfo in LaunchActivatedEventArgs quando l'utente avvia l'app dal riquadro animato. In questo modo è possibile sapere quali notifiche di riquadro l'utente ha visto quando ha toccato il riquadro animato. Nei dispositivi senza l'aggiornamento dell'anniversario, questo verrà semplicemente ignorato.
BaseUri URI false URL di base predefinito combinato con URL relativi negli attributi dell'origine dell'immagine.
AddImageQuery bool? false Impostare su "true" per consentire a Windows di aggiungere una stringa di query all'URL dell'immagine fornito nella notifica di tipo avviso popup. 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, il valore "www.website.com/images/hello.png" specificato nella notifica diventa "www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us"
Lingua string false Impostazioni locali di destinazione del payload visivo quando si usano risorse localizzate, specificate come tag di lingua BCP-47, ad esempio "en-US" o "fr-FR". Queste impostazioni locali vengono sostituite da tutte le impostazioni locali specificate nell'associazione o nel testo. Se non specificato, verranno invece usate le impostazioni locali di sistema.

ITileBindingContent

Interfaccia marcatore per il contenuto dell'associazione di riquadri. Questi consentono di scegliere gli oggetti visivi dei riquadri in - Adattivo o uno dei modelli speciali.

Implementazioni
TileBindingContentAdaptive
TileBindingContentIconic
TileBindingContentContact
TileBindingContent Persone
TileBindingContent Foto

TileBindingContentAdaptive

Supportato in tutte le dimensioni. Questo è il modo consigliato per specificare il contenuto del riquadro. Modelli di riquadri adattivi nuovi in Windows 10 ed è possibile creare un'ampia gamma di riquadri personalizzati tramite adaptive.

Proprietà Type Obbligatorio Descrizione
Children IList<ITileBindingContentAdaptiveChild> false Elementi visivi inline. È possibile aggiungere oggetti AdaptiveText, AdaptiveImage e AdaptiveGroup . Gli elementi figlio vengono visualizzati in modo verticale StackPanel.
BackgroundImage TileBackgroundImage false Un'immagine di sfondo facoltativa che viene visualizzata dietro tutto il contenuto del riquadro, pieno smarginato.
PeekImage TilePeekImage false Immagine a comparsa facoltativa che si anima dalla parte superiore del riquadro.
TextStacking TileTextStacking false Controlla lo stack di testo (allineamento verticale) del contenuto figlio nel suo complesso.

AdaptiveText

Elemento di testo adattivo.

Proprietà Type Obbligatorio Descrizione
Testo string false Il testo da visualizzare.
HintStyle AdaptiveTextStyle false Lo stile controlla le dimensioni, lo spessore e l'opacità del testo del testo.
HintWrap bool? false Impostare questa proprietà su true per abilitare il ritorno a capo del testo. Il valore predefinito è falso.
HintMaxLines int? false Il numero massimo di righe consentite per la visualizzazione dell'elemento di testo.
HintMinLines int? false Numero minimo di righe che l'elemento di testo deve visualizzare.
HintAlign AdaptiveTextAlign false L'allineamento orizzontale del testo.
Lingua string false 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 qualsiasi altra impostazione locale specificata, ad esempio quella nell'associazione o nell'oggetto visivo. Se questo valore è una stringa letterale, per impostazione predefinita questo attributo corrisponde alla lingua dell'interfaccia utente dell'utente. Se questo valore è un riferimento stringa, per impostazione predefinita questo attributo corrisponde alle impostazioni locali scelte da Windows Runtime nella risoluzione della stringa.

AdaptiveTextStyle

Lo stile del testo controlla le dimensioni, lo spessore e l'opacità del carattere. L'opacità sottile è 60% opacità.

Valore Significato
Predefinita Valore predefinito. Lo stile è determinato dal renderer.
Caption Dimensioni inferiori al carattere del paragrafo.
CaptionSubtle Uguale a Caption ma con opacità sottile.
Testo Dimensioni del carattere di paragrafo.
BodySubtle Uguale a Body ma con opacità sottile.
Base Dimensioni carattere paragrafo, spessore grassetto. Essenzialmente la versione grassetto di Body.
BaseSubtle Uguale a Base ma con opacità sottile.
Sottotitolo Font size H4.
SubtitleSubtle Uguale a Subtitle ma con opacità sottile.
Title Font size H3.
TitleSubtle Uguale a Title ma con opacità sottile.
TitleNumeral Uguale a Titolo ma con spaziatura interna superiore/inferiore rimossa.
Subheader Font size H2.
SottoheaderSubtle Uguale a Subheader ma con opacità sottile.
SottotitoloNumeral Uguale a Subheader ma con spaziatura interna superiore/inferiore rimossa.
Intestazione Font size H1.
HeaderSubtle Uguale a Header ma con opacità sottile.
HeaderNumeral Uguale a Header ma con spaziatura interna superiore/inferiore rimossa.

AdaptiveTextAlign

Controlla l'allineamento orizzontale del testo.

Valore Significato
Predefinita Valore predefinito. L'allineamento viene determinato automaticamente dal renderer.
Auto Allineamento determinato dalla lingua e dalle impostazioni cultura correnti.
A sinistra Allinea orizzontalmente il testo a sinistra.
Center Allinea orizzontalmente il testo al centro.
A destra Allinea orizzontalmente il testo a destra.

AdaptiveImage

Immagine inline.

Proprietà Type Obbligatorio Descrizione
Origine string true L'URL dell'immagine. ms-appx, ms-appdata e http sono supportati. A partire da Fall Creators Update, le immagini Web possono essere fino a 3 MB per le connessioni normali e 1 MB sulle connessioni a consumo. Nei dispositivi che non eseguono ancora Fall Creators Update, le immagini Web non devono superare i 200 KB.
HintCrop AdaptiveImageCrop false Controllare il ritaglio desiderato dell'immagine.
HintRemoveMargin bool? false Per impostazione predefinita, le immagini all'interno di gruppi/sottogruppi hanno un margine di 8 px intorno a esse. È possibile rimuovere questo margine impostando questa proprietà su true.
HintAlign AdaptiveImageAlign false L'allineamento orizzontale dell'immagine.
AlternateText string false Testo alternativo che descrive l'immagine, usata a scopo di accessibilità.
AddImageQuery bool? false Impostare su "true" per consentire a Windows di aggiungere una stringa di query all'URL 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, il valore "www.website.com/images/hello.png" specificato nella notifica diventa "www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us"

AdaptiveImageCrop

Specifica il ritaglio desiderato dell'immagine.

Valore Significato
Predefinita Valore predefinito. Comportamento di ritaglio determinato dal renderer.
Nessuno L'immagine non viene ritagliata.
Cerchio vuoto L'immagine viene ritagliata a forma di cerchio.

AdaptiveImageAlign

Specifica l'allineamento orizzontale di un'immagine.

Valore Significato
Predefinita Valore predefinito. Comportamento di allineamento determinato dal renderer.
Estendi L'immagine si estende fino alla larghezza disponibile (e potenzialmente disponibile anche l'altezza, a seconda della posizione in cui viene posizionata l'immagine).
A sinistra Allineare l'immagine a sinistra, visualizzando l'immagine in corrispondenza della risoluzione nativa.
Center Allineare l'immagine al centro orizzontalmente, visualizzando l'immagine alla risoluzione nativa.
A destra Allineare l'immagine a destra, visualizzando l'immagine in corrispondenza della risoluzione nativa.

AdaptiveGroup

I gruppi identificano semanticamente che il contenuto del gruppo deve essere visualizzato nel suo complesso oppure non deve essere visualizzato se non è in grado di adattarsi. I gruppi consentono anche di creare più colonne.

Proprietà Type Obbligatorio Descrizione
Children IList<AdaptiveSubgroup> false I sottogruppi vengono visualizzati come colonne verticali. È necessario usare i sottogruppi per fornire qualsiasi contenuto all'interno di un adaptivegroup.

AdaptiveSubgroup

I sottogruppi sono colonne verticali che possono contenere testo e immagini.

Proprietà Type Obbligatorio Descrizione
Children IList<IAdaptiveSubgroupChild> false AdaptiveText e AdaptiveImage sono elementi figlio validi di sottogruppi.
HintWeight int? false Controllare la larghezza di questa colonna del sottogruppo specificando il peso, rispetto agli altri sottogruppi.
HintTextStacking AdaptiveSubgroupTextStacking false Controllare l'allineamento verticale del contenuto del sottogruppo.

IAdaptiveSubgroupChild

Interfaccia del marcatore per gli elementi figlio del sottogruppo.

Implementazioni
AdaptiveText
AdaptiveImage

AdaptiveSubgroupTextStacking

TextStacking specifica l'allineamento verticale del contenuto.

Valore Significato
Predefinita Valore predefinito. Il renderer seleziona automaticamente l'allineamento verticale predefinito.
In alto Allinea verticalmente alla parte superiore.
Center Allinea verticalmente al centro.
In basso Allineamento verticale verso il basso.

TileBackgroundImage

Immagine di sfondo visualizzata a smarginamento completo nel riquadro.

Proprietà Type Obbligatorio Descrizione
Origine string true L'URL dell'immagine. ms-appx, ms-appdata e http(s) sono supportati. Le immagini HTTP devono avere dimensioni inferiori o inferiori a 200 KB.
HintOverlay int? false Sovrapposizione nera sull'immagine di sfondo. Questo valore controlla l'opacità della sovrimpressione nera, con 0 senza sovrapposizione e 100 completamente nero. L'impostazione predefinita è 20.
HintCrop TileBackgroundImageCrop false Novità nella versione 1511: specificare la modalità di ritaglio dell'immagine. Nelle versioni precedenti alla 1511, questa verrà ignorata e l'immagine di sfondo verrà visualizzata senza ritaglio.
AlternateText string false Testo alternativo che descrive l'immagine, usata a scopo di accessibilità.
AddImageQuery bool? false Impostare su "true" per consentire a Windows di aggiungere una stringa di query all'URL 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, il valore "www.website.com/images/hello.png" specificato nella notifica diventa "www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us"

TileBackgroundImageCrop

Controlla il ritaglio dell'immagine di sfondo.

Valore Significato
Predefinita Il ritaglio usa il comportamento predefinito del renderer.
Nessuno L'immagine non viene ritagliata, visualizzata al quadrato.
Cerchio vuoto L'immagine viene ritagliata in un cerchio.

TilePeekImage

Immagine a comparsa che si anima dalla parte superiore del riquadro.

Proprietà Type Obbligatorio Descrizione
Origine string true L'URL dell'immagine. ms-appx, ms-appdata e http(s) sono supportati. Le immagini HTTP devono avere dimensioni inferiori o inferiori a 200 KB.
HintOverlay int? false Novità della versione 1511: una sovrimpressione nera sull'immagine a comparsa. Questo valore controlla l'opacità della sovrimpressione nera, con 0 senza sovrapposizione e 100 completamente nero. L'impostazione predefinita è 20. Nelle versioni precedenti questo valore verrà ignorato e verrà visualizzata un'immagine a comparsa con 0 sovrimpressione.
HintCrop TilePeekImageCrop false Novità nella versione 1511: specificare la modalità di ritaglio dell'immagine. Nelle versioni precedenti alla 1511, questa verrà ignorata e l'immagine di anteprima verrà visualizzata senza ritaglio.
AlternateText string false Testo alternativo che descrive l'immagine, usata a scopo di accessibilità.
AddImageQuery bool? false Impostare su "true" per consentire a Windows di aggiungere una stringa di query all'URL 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, il valore "www.website.com/images/hello.png" specificato nella notifica diventa "www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us"

TilePeekImageCrop

Controlla il ritaglio dell'immagine di anteprima.

Valore Significato
Predefinita Il ritaglio usa il comportamento predefinito del renderer.
Nessuno L'immagine non viene ritagliata, visualizzata al quadrato.
Cerchio vuoto L'immagine viene ritagliata in un cerchio.

TileTextStacking

L'impilamento del testo specifica l'allineamento verticale del contenuto.

Valore Significato
Predefinita Valore predefinito. Il renderer seleziona automaticamente l'allineamento verticale predefinito.
In alto Allinea verticalmente alla parte superiore.
Center Allinea verticalmente al centro.
In basso Allineamento verticale verso il basso.

TileBindingContentIconic

Supportato in Small e Medium. Abilita un modello di riquadro iconico, in cui è possibile visualizzare un'icona e una notifica accanto all'altra nel riquadro, in un vero stile classico di Windows Telefono. Il numero accanto all'icona viene ottenuto tramite una notifica di notifica separata.

Proprietà Type Obbligatorio Descrizione
Icona TileBasicImage true Per supportare almeno i riquadri Desktop e Mobile, Small e Medium, fornire un'immagine delle proporzioni quadrate con una risoluzione di 200x200, formato PNG, con trasparenza e nessun colore diverso dal bianco. Per altre info, vedi: Modelli di riquadri speciali.

TileBindingContentContact

Solo dispositivi mobili. Supportato in Small, Medium e Wide.

Proprietà Type Obbligatorio Descrizione
Image TileBasicImage true L'immagine da visualizzare.
Text TileBasicText false Riga di testo visualizzata. Non visualizzato in un riquadro piccolo.

TileBindingContentPeople

Novità della versione 1511: supportata in media, wide e grande (desktop e dispositivi mobili). In precedenza questo era solo mobile e solo Medio e Wide.

Proprietà Type Obbligatorio Descrizione
Immagini IList<TileBasicImage> true Immagini che verranno ruotate come cerchi.

TileBindingContentPhotos

Anima attraverso una presentazione di foto. Supportato in tutte le dimensioni.

Proprietà Type Obbligatorio Descrizione
Immagini IList<TileBasicImage> true È possibile fornire fino a 12 immagini (Mobile visualizzerà fino a 9), che verrà usato per la presentazione. L'aggiunta di più di 12 genererà un'eccezione.

TileBasicImage

Immagine usata in vari modelli speciali.

Proprietà Type Obbligatorio Descrizione
Origine string true L'URL dell'immagine. ms-appx, ms-appdata e http(s) sono supportati. Le immagini HTTP devono avere dimensioni inferiori o inferiori a 200 KB.
AlternateText string false Testo alternativo che descrive l'immagine, usata a scopo di accessibilità.
AddImageQuery bool? false Impostare su "true" per consentire a Windows di aggiungere una stringa di query all'URL 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, il valore "www.website.com/images/hello.png" specificato nella notifica diventa "www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us"

TileBasicText

Elemento di testo di base utilizzato in vari modelli speciali.

Proprietà Type Obbligatorio Descrizione
Testo string false Il testo da visualizzare.
Lingua string false 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 qualsiasi altra impostazione locale specificata, ad esempio quella nell'associazione o nell'oggetto visivo. Se questo valore è una stringa letterale, per impostazione predefinita questo attributo corrisponde alla lingua dell'interfaccia utente dell'utente. Se questo valore è un riferimento stringa, per impostazione predefinita questo attributo corrisponde alle impostazioni locali scelte da Windows Runtime nella risoluzione della stringa.