VisualElements (schema delle estensioni per Windows 8.1)

Articolo
07/20/2023

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

Gerarchia degli elementi

<VisualElements>

Sintassi

<VisualElements DisplayName     = A string between 1 and 256 characters in length. This string is localizable. 
                Description     = A string between 1 and 2048 characters in length that cannot include characters such as tabs, carriage returns, and line feeds.
                ForegroundText  = "light" | "dark"
                BackgroundColor = A three-byte hexadecimal number preceded by "#" or a named color.
                ToastCapable?   = boolean
                Logo            = 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.
                SmallLogo       = 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?
  )

</VisualElements>

Chiave

? facoltativo (zero o uno)

& connettore interleave (può verificarsi in qualsiasi ordine)

Attributi ed elementi

Attributi

Attributo	Descrizione	Tipo di dati	Obbligatoria
BackgroundColor	Specifica il colore di sfondo del riquadro dell'app. Per i nomi dei colori, vedere la sezione Osservazioni. Si noti che il colore di sfondo specificato qui si applica anche a questi elementi: Colore del pulsante in tutte le finestre di dialogo di proprietà dell'app Pagina Descrizione app nel Microsoft Store Si applica Windows Phone: se si sceglie "trasparente" viene usato il colore principale del sistema.	Numero esadecimale a tre byte preceduto da "#" o da un colore denominato.	Sì
Descrizione	Descrizione dell'app. Questa stringa è localizzabile. Per informazioni dettagliate, vedere Note.	Stringa di lunghezza compresa tra 1 e 2048 caratteri che non può includere caratteri quali tabulazioni, ritorno a capo e avanzamento riga.	Sì
DisplayName	Nome descrittivo dell'app che può essere visualizzato agli utenti. Questa stringa è localizzabile. Per informazioni dettagliate, vedere Note. Esistono due parole riservate in modo esplicito che non possono essere usate come DisplayName per le app caricate nel Microsoft Store: "NoUIEntryPoints" e "NoUIEntryPoints-DesignMode". Questi identificatori sono riservati per l'utilizzo degli strumenti di sviluppo e dei gruppi di test.	Stringa di lunghezza compresa tra 1 e 256 caratteri. Questa stringa è localizzabile.	Sì
ForegroundText	Specifica il colore di primo piano del riquadro dell'app. Si applica Windows Phone: se si sceglie "trasparente" viene usato il colore principale del sistema.	Questo attributo può avere uno dei valori seguenti: semplice Scuro	Sì
Logo	Immagine usata come riquadro quadrato dell'app. Per altre informazioni su come specificare l'immagine in questo attributo, vedere 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ì
SmallLogo	Immagine piccola visualizzata nell'angolo del riquadro per identificare l'app. Per altre informazioni su come specificare l'immagine in questo attributo, vedere Osservazioni. Si applica Windows Phone: Windows Phone non supporta il logo piccolo nel riquadro. Viene usato solo nell'elenco Delle app.	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ì
ToastCapable	Il valore true indica che all'app è consentito fornire notifiche di tipo avviso popup. Il valore predefinito è false. Se non si vuole visualizzare le notifiche di tipo avviso popup, non specificare un valore per questo attributo. Si noti che le app non devono decidere se inviare notifiche di tipo avviso popup in base a questo valore.	boolean	No

Elementi figlio

Elemento figlio	Descrizione
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 ha notifiche da visualizzare, viene ripristinata l'impostazione predefinita.
InitialRotationPreference	Descrive gli orientamenti in cui l'app preferisce essere visualizzata per la migliore esperienza utente. 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 Landscape e LandscapeFlipped e il dispositivo viene ruotato con orientamento Verticale, l'app non verrà ruotata. 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) proprietà.
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, che viene visualizzata dall'app durante l'avvio.

Elementi padre

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

Commenti

Per altre informazioni sui requisiti delle dimensioni del riquadro, vedere Dimensioni dei riquadri.

Le immagini Logo e SmallLogo possono essere fornite come percorso diretto di un file di immagine o come risorsa. Con il riferimento a una risorsa puoi specificare immagini con scale diverse, in modo che Windows possa scegliere le dimensioni più adatte per il dispositivo e la risoluzione dello schermo. Puoi anche specificare immagini a contrasto elevato per favorire l'accessibilità e immagini localizzate che corrispondano alle diverse lingue dell'interfaccia utente. Questa funzionalità consente anche di localizzare gli attributi DisplayNamee Description . Per altre informazioni, vedere l'argomento Globalizzazione .

Applicazioni/Applicazione/Estensioni/Estensione/FileTypeAssociation/Logo Applications/Application/Extensions/Extension/Protocol/Logo

I requisiti relativi alle dimensioni di due tipi di immagini del logo sono illustrati di seguito:

Attributo immagine Ridimensiona dimensioni immagine in pixel Applications\Application\VisualElements\@Logo 100 150x150 140 210x210 180 270x270 Applications\Application\VisualElements\@SmallLogo 100 30x30 140 42x42 180 54x54

Questi sono i nomi dei colori di sfondo supportati:

Nome	Nome	Nome	Nome	Nome	Nome
aliceBlue	1000white	acqua	acqua marina	azure	beige
terracotta	black	mondhedAlmond	blue	blueViolet	marrone
burlyWood	cadetBlue	chartreuse	cioccolato	corallo	blufioreBlue
crema	cremisi	ciano	blu scuro	darkCyan	darkGoldenrod
grigio scuro	verde scuro	darkKhaki	Darkmagenta	darkOliveGreen	darkOrange
darkOrchid	darkRed	darkSalmon	darkSeaGreen	darkSlateBlue	darkSlateGray
blu scuro	darkViolet	deepPink	deepSkyBlue	dimGray	blublue
rosso mattone	1000white	forestGreen	fucsia	gainsboro	ghostWhite
oro	oro vivo	grigio	green	greenYellow	miele
hotPink	indiaRed	indaco	avorio	kaki	lavanda
lavenderBlush	lawnGreen	griffonChiffon	Lightblue	lightCoral	lightCyan
lightGoldenrodYellow	verde chiaro	lightGray	lightPink	lightSalmon	lightSeaGreen
lightSkyBlue	lightSlateGray	lightSteelBlue	lightYellow	lime	verde verde verde
bianco lino	magenta	Bordeaux	mediumAquamarine	Mediumblue	mediumOrchid
mediumPurple	mediumSeaGreen	mediumSlateBlue	mediumSpringGreen	mediumTurquoise	mediumVioletRed
midnightBlue	mintCream	mistyRose	sabbia	navajoWhite	blu militare
oldLace	verde oliva	oliveDrab	orange	orangeRed	orchidea
paleGoldenrod	paleGreen	paleTurquoise	paleVioletRed	papayaWhip	peachPuff
marrone chiaro	pink	prugna	tuttoblue	purple	rosso
rosyBrown	royalBlue	sellaBrown	salmone	sandBrown	seaGreen
Seashell	cuoio	argento	skyBlue	slateBlue	slateGray
neve	springGreen	steelBlue	tan	verde acqua	rosa cenere
pomodoro	transparent	turchese	violetto	grano	white
Whitesmoke	yellow	yellowGreen

Esempio

L'esempio seguente è tratto dal manifesto del pacchetto di un esempio SDK.

                    
<Applications>
    <Application Id="App" StartPage="default.html">
        <VisualElements 
            DisplayName="ApplicationDataSample" 
            Logo="images\squareTile-sdk.png" 
            SmallLogo="images\smallTile-sdk.png" 
            Description="Application data sample" 
            ForegroundText="dark" 
            BackgroundColor="#FFFFFF" 
            ToastCapable="false">
            <DefaultTile ShowName="allLogos"/>
            <SplashScreen BackgroundColor="white" Image="images\splash-sdk.png"/>
        </VisualElements>
    </Application>
</Applications>

Vedi anche

Immagini e screenshot delle app

Classe Colors

Guida introduttiva: Creazione di un riquadro predefinito usando l'editor Visual Studio manifesto

Requisiti

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