VisualElements (schema del pacchetto per Windows 8)

Articolo
07/20/2023

Descrive gli aspetti visivi dell'app UWP: il riquadro predefinito, le immagini di 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

<Pacchetto>

<Applicazioni>

<Applicazione>: <VisualElements>

Sintassi

<VisualElements DisplayName     = A string between 1 and 256 characters in length.
                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.
                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 >

  <!-- 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. Vedere la sezione Osservazioni per i nomi dei colori. 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 nella Microsoft Store Si applica a Windows Phone: la scelta di "trasparente" causa l'uso del colore accento 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 Osservazioni.	Stringa compresa tra 1 e 2048 caratteri in lunghezza che non possono includere caratteri come schede, ritorno a capo e feed di riga.	Sì
DisplayName	Nome descrittivo per l'app che può essere visualizzata agli utenti. Questa stringa è localizzabile; per informazioni dettagliate, vedere Osservazioni. Esistono due parole riservate in modo esplicito che potrebbero non essere usate come DisplayName per le app caricate nella Microsoft Store: "NoUIEntryPoints" e "NoUIEntryPoints-DesignMode". Questi identificatori sono riservati per l'utilizzo degli strumenti di sviluppo e dei gruppi di test.	Stringa compresa tra 1 e 256 caratteri in lunghezza.	Sì
ForegroundText	Specifica il colore di primo piano del riquadro dell'app. Si applica a Windows Phone: questo valore viene ignorato. Tutti i riquadri usano il colore del testo chiaro.	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 compresa tra 1 e 256 caratteri in lunghezza che termina con ".jpg", ".png" o ".jpeg" che non può contenere questi caratteri: <, >, %, ", \|, ?o *. In questa stringa i caratteri / e \ non possono essere i primi o gli ultimi caratteri. Inoltre, la stringa può contenere / o \ ma non entrambi.	Sì
SmallLogo	Un'immagine piccola mostrata nell'angolo del riquadro per identificare l'app. Per altre informazioni su come specificare l'immagine in questo attributo, vedere Osservazioni. Si applica a Windows Phone: Windows Phone non visualizza il piccolo logo nel riquadro. Viene usato solo nell'elenco App.	Stringa compresa tra 1 e 256 caratteri in lunghezza che termina con ".jpg", ".png" o ".jpeg" che non può contenere questi caratteri: <, >, %, ", \|, ?o *. In questa stringa i caratteri / e \ non possono essere i primi o gli ultimi caratteri. Inoltre, la stringa può contenere / o \ ma non entrambi.	Sì
Popup Non è possibile	Un valore true indica che l'app può fornire notifiche di tipo avviso popup. Il valore predefinito è false. Se non si desidera che vengano visualizzate le notifiche di tipo avviso popup, non specificare un valore per questo attributo. Si noti che le app non devono prendere decisioni su 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 nella schermata Start. Questo riquadro viene visualizzato quando l'app viene installata prima di ricevere notifiche di aggiornamento. Quando un riquadro non ha notifiche da visualizzare, il riquadro viene ripristinato in questo valore predefinito.
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 su un orientamento Verticale, l'app non ruota. Si noti che nei dispositivi che non possono essere ruotati, un'app potrebbe essere visualizzata nell'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 sarà comunque onorata. 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 durante l'esecuzione tramite [AutoRotationPreferences](/uwp/api/Windows. Proprietà Graphics.Display.DisplayProperties).
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

Elemento padre	Descrizione
Applicazione	Rappresenta un'app che comprende parte o tutte le funzionalità recapitate nel pacchetto.

Commenti

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

Le immagini Logo e SmallLogo possono essere fornite come percorso diretto a 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 DisplayName e Description . Per altre info, vedi l'argomento Globalizzazione .

Applications/Application/Extensions/Extension/FileTypeAssociation/Logo Applications/Application/Extensions/Extension/Protocol/Logo

I requisiti di dimensione di due tipi di immagini logo sono illustrati di seguito:

Dimensione immagine scala immagine in pixel Applications\Application\VisualElements\@Logo 100 150x150 140 210x210 180 270x270 Applications\Application\VisualElements\@SmallLogo 100 30x30 140 42x42 180 54x544

Questi sono i nomi dei colori di sfondo supportati:

Nome	Nome	Nome	Nome	Nome	Nome
AliceBlue	anticoWhite	acqua	acqua marina	azure	beige
terracotta	black	biancadAlmond	blue	blueViolet	marrone
burlyWood	cadetBlue	chartreuse	cioccolato	corallo	cornflowerBlue
crema	cremisi	ciano	Blu scuro	ciano scuro	dark Goldenrod
darkGray	Verde scuro	darkKhaki	Darkmagenta	darkOliveGreen	darkOrange
darkOrchid	darkRed	darkSalmon	DarkSeaGreen	blu scuro	darkSlateGray
darkTurquoise	darkViolet	deepPink	deepSkyBlue	dimGray	DodgerBlue
rosso mattone	florealeWhite	foresta verde	fucsia	gainsboro	fantasmaWhite
oro	oro vivo	grigio	green	greenYellow	miele
hotPink	indianRed	indaco	avorio	kaki	lavanda
lavandaBlush	prato verde	lemonChiffon	Lightblue	lightCoral	ciano chiaro
light GoldenrodYellow	verde chiaro	lightGray	lightPink	lightSalmon	lightSeaGreen
lightSkyBlue	lightSlateGray	lightSteelBlue	lightYellow	lime	limeGreen
bianco lino	magenta	Bordeaux	mediumAquamarine	Mediumblue	mediumOrchid
mediumPurple	mediumSeaGreen	mediumSlateBlue	mediumSpringGreen	mediumTurquoise	mediumVioletRed
mezzanotte Blu	mintCream	mistyRose	sabbia	navajoWhite	blu militare
oldLace	verde oliva	oliveDrab	orange	orangeRed	orchidea
pale Goldenrod	verde pallido	paleTurquoise	paleVioletRed	papayaWhip	pescaPuffo
marrone chiaro	pink	prugna	polvere blu	purple	rosso
rosyBrown	royalBlue	sellaBrown	salmone	sandyBrown	verde mare
Seashell	cuoio	argento	cielo blu	slateBlue	slateGray
neve	verde primavera	acciaio Blu	tan	verde acqua	rosa cenere
pomodoro	transparent	turchese	violetto	grano	white
Whitesmoke	yellow	giallo verde

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 con l'editor del manifesto Visual Studio

Requisiti

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