VisualElements (schema delle estensioni delle funzionalità per Windows 8.1)

Articolo
07/20/2023

Descrive gli aspetti visivi dell'app UWP: il riquadro predefinito, le immagini del logo, il testo e i colori di sfondo, l'orientamento iniziale dello schermo, la schermata iniziale e l'aspetto del riquadro della schermata di blocco.

Gerarchia degli elementi

<VisualElements>

Sintassi

<VisualElements Square150x150Logo = A string between 1 and 256 characters in length that ends with ".jpg", ".png", or ".jpeg" that can't contain these characters: <, >, :, ", |, ?, or *. In this string, the / and \ characters can't be the first or last characters. Also, the string can contain / or \ but not both.
                Square30x30Logo   = A string between 1 and 256 characters in length that ends with ".jpg", ".png", or ".jpeg" that can't contain these characters: <, >, :, ", |, ?, or *. In this string, the / and \ characters can't be the first or last characters. Also, the string can contain / or \ but not both. >

  <!-- Child elements -->
  ( DefaultTile?
  & LockScreen?
  & SplashScreen
  & InitialRotationPreference?
  & ApplicationView?
  )

</VisualElements>

Chiave

? facoltativo (zero o uno)

& connettore interleave (può verificarsi in qualsiasi ordine)

Attributi ed elementi

Attributi

Attributo	Descrizione	Tipo di dati	Obbligatoria	Valore predefinito
Square150x150Logo	Immagine 150x150 usata come riquadro quadrato dell'app. Per altre informazioni su come specificare l'immagine in questo attributo, vedere La sezione Osservazioni.	Stringa di lunghezza compresa tra 1 e 256 caratteri che termina con ".jpg", ".png" o ".jpeg" che non può contenere questi caratteri: <, >, :, ", \|, ?, o *. In questa stringa i caratteri / e \ non possono essere il primo o l'ultimo carattere. Inoltre, la stringa può contenere / o \ ma non entrambi.	Sì
Square30x30Logo	Immagine 30x30 usata come riquadro quadrato dell'app. Per altre informazioni su come specificare l'immagine in questo attributo, vedere La sezione Osservazioni.	Stringa di lunghezza compresa tra 1 e 256 caratteri che termina con ".jpg", ".png" o ".jpeg" che non può contenere questi caratteri: <, >, :, ", \|, ?, o *. In questa stringa i caratteri / e \ non possono essere il primo o l'ultimo carattere. Inoltre, la stringa può contenere / o \ ma non entrambi.	Sì

Elementi figlio

Elemento figlio	Descrizione
ApplicationView	Descrive come viene visualizzata l'app sullo schermo.
DefaultTile	Riquadro predefinito che rappresenta l'app nel schermata Start. Questo riquadro viene visualizzato quando l'app viene installata per la prima volta, prima di ricevere le notifiche di aggiornamento. Quando un riquadro non contiene notifiche da visualizzare, viene ripristinata l'impostazione predefinita.
InitialRotationPreference	Descrive gli orientamenti in cui l'app preferisce essere visualizzata per un'esperienza utente ottimale. In un dispositivo che può essere ruotato, ad esempio un tablet, l'app non verrà ridisegnata per gli orientamenti non specificati qui. Ad esempio, se l'app specifica solo gli orientamenti Orizzontale e OrizzontaleF ritagliato e il dispositivo viene ruotato con orientamento Verticale, l'app non ruota. Si noti che nei dispositivi che non possono essere ruotati, un'app potrebbe essere visualizzata con l'orientamento predefinito del dispositivo e l'orientamento preferito dell'app verrà ignorato. Tuttavia, in un dispositivo con un blocco di rotazione attivato, la rotazione preferita dell'app verrà comunque rispettata. Queste scelte di preferenza di orientamento si applicano sia alla [schermata iniziale](element-splashscreen.md) che all'interfaccia utente dell'app quando viene avviata una nuova sessione per l'app. Le preferenze possono essere modificate in fase di esecuzione tramite [AutoRotationPreferences](/uwp/api/Windows. Graphics.Display.DisplayInformation).
LockScreen	Definisce la notifica e le notifiche che rappresentano l'app nella schermata di blocco, che viene visualizzata quando il sistema è bloccato.
SplashScreen	Definisce l'aspetto della schermata iniziale, visualizzata dall'app durante l'avvio.

Elementi padre

Questo elemento più esterno (documento) potrebbe non essere contenuto da altri elementi.

Commenti

Per altre informazioni sugli aspetti visivi per le app, vedi VisualElements.

Il manifesto esegue questi controlli semantici per VisualElements, che non vengono applicati nello schema.

Se viene specificato DefaultTile\Square310x310Logo , è necessario specificare anche DefaultTile\Wide310x150Logo .
Se DefaultTile\DefaultSize o ShowNameOnTiles specifica un determinato valore per le dimensioni dell'immagine, tale dimensione deve essere stata dichiarata nel manifesto.
Se LockScreen\Notification è impostato su badgeAndTileText, è necessario specificare DefaultTile\Wide310x150Logo .

Le immagini Square150x150Logo e Square30x30Logo possono essere fornite come percorso diretto a un file di immagine o come risorsa. Usando un riferimento alla risorsa, è possibile fornire immagini localizzate in modo che corrispondano alle diverse lingue dell'interfaccia utente. Per altre informazioni, vedere l'argomento Globalizzazione .

Requisiti

	Valore
Namespace	`http://schemas.microsoft.com/appx/2013/manifest`

Condividi tramite