uap3:VisualElements (Windows 10)

Articolo
05/03/2024

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

Gerarchia degli elementi

<uap3:VisualElements>

Sintassi

<uap3:VisualElements
    DisplayName = 'A string with a value between 1 and 256 characters in length. This string is localizable.' 
    Description = 'A string between 1 and 2048 characters in length.'
    BackgroundColor = 'A three-byte hexadecimal number preceded by "#" or a named color. See Remarks for a list of named colors.'
    Square150x150Logo = 'A string with a value between 1 and 256 characters in length that ends with ".jpg", ".png", or ".jpeg" that cannot contain these characters: <, >, :, ", |, ?, or *. In this string, the / and \ characters cannot be the first or last characters. Also, the string can contain / or \ but not both.'
    Square44x44Logo = 'A string with a value between 1 and 256 characters in length that ends with ".jpg", ".png", or ".jpeg" that cannot contain these characters: <, >, :, ", |, ?, or *. In this string, the / and \ characters cannot be the first or last characters. Also, the string can contain / or \ but not both.'
    AppListEntry = 'An optional string that can have one of the following values: "default" or "none".' 
    VisualGroup = 'A string with a value between 1 and 256 characters in length that does not contain backslashes ("\").' />

  <!-- Child elements -->
  uap:DefaultTile?
  & uap:LockScreen?
  & uap:SplashScreen?
  & uap:InitialRotationPreference?

</uap3:VisualElements>

Chiave

? connettore facoltativo (zero o uno) & interleave (può verificarsi in qualsiasi ordine)

Attributi ed elementi

Attributi

Attributo	Descrizione	Tipo di dati	Obbligatoria
DisplayName	Nome descrittivo per l'app che può essere visualizzato agli utenti. Questa stringa è localizzabile; per informazioni dettagliate, vedere Osservazioni.	Stringa con un valore compreso tra 1 e 256 caratteri in lunghezza. Questa stringa è localizzabile.	Sì
Descrizione	Descrizione dell'app. Questa stringa è localizzabile; per informazioni dettagliate, vedere Osservazioni .	Stringa compresa tra 1 e 2048 caratteri in lunghezza.	Sì
BackgroundColor	Specifica il colore di sfondo del riquadro dell'app.	Numero esadecimale a tre byte preceduto da o da `#` un colore denominato. Vedere Osservazioni per un elenco di colori denominati .	Sì
Square150x150Logo	Immagine usata come riquadro Medio schermata iniziale dell'app e nel commutatore attività. Per altre informazioni su come specificare l'immagine in questo attributo, vedere Osservazioni.	Stringa con un valore compreso tra 1 e 256 caratteri in lunghezza che termina con , o che non può contenere questi caratteri: `":?\|<>`, `.png`o .`*.jpeg.jpg` In questa stringa i caratteri e `\` non possono essere i `/` primi o gli ultimi caratteri. Inoltre, la stringa può contenere `/` o `\` non entrambi.	Sì
Square44x44Logo	Immagine usata come riquadro iniziale dell'app e nell'elenco tutte le app. Per altre informazioni su come specificare l'immagine in questo attributo, vedere Osservazioni.	Stringa con un valore compreso tra 1 e 256 caratteri in lunghezza che termina con , o che non può contenere questi caratteri: `":?\|<>`, `.png`o .`*.jpeg.jpg` In questa stringa i caratteri e `\` non possono essere i `/` primi o gli ultimi caratteri. Inoltre, la stringa può contenere `/` o `\` non entrambi.	Sì
AppListEntry	Voce nell'elenco tutte le app.	Stringa facoltativa che può avere uno dei valori seguenti: impostazione predefinita o nessuna.	No
VisualGroup	Nome di una cartella da creare nell'elenco tutte le app, in cui deve essere archiviato il riquadro per l'app.	Stringa con un valore compreso tra 1 e 256 caratteri in lunghezza che non contiene barre rovesciate (`\`) o spazi.	No

Nota

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 nello Store.

Elementi figlio

Elemento figlio	Descrizione
uap:DefaultTile	Definisce il 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.
uap:LockScreen	Definisce la notifica e le notifiche che rappresentano l'app nella schermata di blocco, che viene visualizzata quando il sistema è bloccato.
uap:SplashScreen	Definisce l'aspetto della schermata iniziale, visualizzata dall'app durante l'avvio.
uap:InitialRotationPreference	Descrive gli orientamenti in cui l'app preferisce essere visualizzata per la migliore esperienza utente.

Elementi padre

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

Commenti

Non è possibile usare l'attributo VisualGroup per creare una struttura di cartelle annidate. Se si include una barra rovesciata (\) nel valore, si verifica un errore.

L'attributo VisualGroup non è valido se il manifesto dichiara solo un'app.

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

Per le immagini Square150x150Logo e Square44x44Logo , è possibile fornire immagini di scale diverse in modo che Windows possa scegliere le dimensioni migliori 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 informazioni, vedere gli argomenti globalizzazione e localizzazione del manifesto del pacchetto .

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

Attributo image	Scala (dimensioni dell'immagine in pixel)
`Applications/Application/VisualElements/@Square150x150Logo`	100 (150x150)
	250 (375x375)
`Applications/Application/VisualElements/@Square44x44Logo`	100 (44x44)
	250 (110x110)
`Applications/Application/VisualElements/@Tall150x310Logo`	100 (150x310)
	250 (375x775)

Questi sono i nomi di colore di sfondo supportati:

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
lightGray
verde chiaro
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
paleGoldenrod
paleGreen
paleTurquoise
paleVioletRed
papayaWhip
pescaPuffo
marrone chiaro
pink
prugna
polvereBlue
purple
rosso
rosyBrown
royalBlue
sellaBrown
salmone

sandyBrown
seaGreen
Seashell
cuoio
argento
skyBlue
slateBlue
slateGray
neve
springGreen
acciaioBlue
tan
verde acqua
rosa cenere
pomodoro
transparent
turchese
violetto
grano
white
Whitesmoke
yellow
giallo Verde

Esempio

Nell'esempio seguente viene creata una cartella denominata App1 nell'elenco tutte le app e viene archiviato il riquadro per App1 in tale cartella.

<Package
    xmlns:desktop="http://schemas.microsoft.com/appx/manifest/desktop/windows10"  
    IgnorableNamespaces="... desktop">
    <Applications>
        <Application>
            <uap3:VisualElements
                DisplayName="App1" 
                Square150x150Logo="images/150x150.png" 
                Square44x44Logo="images/44x44.png" 
                Description="App1" 
                BackgroundColor="#777777" 
                AppListEntry="default" 
                VisualGroup="App1">  
                <uap:SplashScreen
                    BackgroundColor="#777777" 
                    Image="images/splash.png"/>  
           </uap3:VisualElements>  
        </Application>
    </Applications>
</Package>

Requisiti

Elemento	Valore
Namespace	`http://schemas.microsoft.com/appx/manifest/uap/windows10/3`
Minimum OS Version	Windows 10 versione 1607 (Build 14393)

Condividi tramite

uap3:VisualElements (Windows 10)

Gerarchia degli elementi

Sintassi

Chiave

Attributi ed elementi

Attributi

Elementi figlio

Elementi padre

Commenti

Esempio

Requisiti

Commenti e suggerimenti

Risorse aggiuntive

Condividi tramite

uap3:VisualElements (Windows 10)

Gerarchia degli elementi

Sintassi

Chiave

Attributi ed elementi

Attributi

Elementi figlio

Elementi padre

Commenti

Esempio

Argomenti correlati

Requisiti

Commenti e suggerimenti

Risorse aggiuntive