uap:VisualElements (Windows 10)
Descrive gli aspetti visivi dell'app: il riquadro predefinito, le immagini del logo, i colori di testo e di sfondo, l'orientamento iniziale dello schermo, la schermata iniziale e l'aspetto del riquadro della schermata di blocco.
Gerarchia degli elementi
<uap:VisualElements>
Sintassi
<uap:VisualElements
DisplayName = 'A string with a value between 1 and 256 characters. This string is localizable.'
Description = 'A string between 1 and 2048 characters.'
BackgroundColor = 'A three-byte hexadecimal number preceded by "#" or a named color. See Remarks for a list of named colors.'
Square150x150Logo = 'A string 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 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".' >
<!-- Child elements -->
uap:DefaultTile?
& uap:LockScreen?
& uap:SplashScreen?
& uap:InitialRotationPreference?
</uap:VisualElements>
Chiave
? connettore di interleave facoltativo (zero o uno) & (può verificarsi in qualsiasi ordine)
Attributi ed elementi
Attributi
| Attributo | Descrizione | Tipo di dati | Obbligatoria | Valore predefinito |
|---|---|---|---|---|
| DisplayName | Nome descrittivo per l'app che può essere visualizzato agli utenti. Questa stringa è localizzabile; per informazioni dettagliate, vedere la sezione Note . | Stringa con un valore compreso tra 1 e 256 caratteri. Questa stringa è localizzabile. | Sì | |
| Descrizione | Descrizione dell'app. Questa stringa è localizzabile; per informazioni dettagliate, vedere la sezione Note . | Stringa compresa tra 1 e 2048 caratteri. | Sì | |
| BackgroundColor | Specifica il colore di sfondo del riquadro dell'app. Vedere la sezione Osservazioni per i nomi dei colori. | Sì | ||
| Square150x150Logo | Immagine usata come riquadro medio della schermata Start dell'app e nel commutatore attività. Per altre info su come specificare l'immagine in questo attributo, vedi Osservazioni. | Stringa compresa tra 1 e 256 caratteri che termina con , o che non può contenere questi caratteri: <, >, ":, |, , ?o *..jpeg.png.jpg In questa stringa i / caratteri e \ non possono essere i primi o gli ultimi caratteri. Inoltre, la stringa può contenere / o \ non entrambe. |
Sì | |
| Square44x44Logo | Immagine usata come riquadro piccolo della schermata Start dell'app e nell'elenco Tutte le app. Per altre info su come specificare l'immagine in questo attributo, vedi Osservazioni. | Stringa compresa tra 1 e 256 caratteri che termina con , o che non può contenere questi caratteri: <, >, ":, |, , ?o *..jpeg.png.jpg In questa stringa i / caratteri e \ non possono essere i primi o gli ultimi caratteri. Inoltre, la stringa può contenere / o \ non entrambe. |
Sì | |
| AppListEntry | Voce nell'elenco Tutte le app. Selezionare nessuno per i punti di ingresso che non richiedono riquadri del menu Start. | Stringa facoltativa che può avere uno dei valori seguenti: "default" o "none". | No | default |
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 | Riquadro predefinito che rappresenta l'app nella schermata Start. Questo riquadro viene visualizzato quando l'app viene installata per la prima volta, prima che abbia ricevuto notifiche di aggiornamento. Quando un riquadro non contiene notifiche da visualizzare, il riquadro torna a questa impostazione predefinita. |
| uap: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 Landscape gli orientamenti e LandscapeFlipped e il dispositivo viene ruotato su un Portrait orientamento, l'app non verrà ruotata. |
| 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. |
Nota
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 verrà comunque rispettata.
Queste scelte di preferenza di orientamento si applicano sia alla schermata iniziale che all'interfaccia utente dell'app quando viene avviata una nuova sessione per l'app. Le preferenze possono essere modificate durante l'esecuzione tramite la proprietà AutoRotationPreferences .
Elementi padre
| Elemento padre | Descrizione |
|---|---|
| Applicazione | Rappresenta un'app che include parte o tutte le funzionalità fornite nel pacchetto. |
Commenti
Per altre informazioni sui requisiti delle dimensioni dei riquadri, vedi Dimensioni dei riquadri.
Per le immagini Square150x150Logo e Square44x44Logo , puoi 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 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:
| 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 dei colori 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
arancioneRed
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
L'esempio seguente viene tratto dal manifesto del pacchetto di un esempio SDK.
<Applications>
<Application Id="App" StartPage="default.html">
<uap:VisualElements
DisplayName="ApplicationDataSample"
Description="Application data sample"
BackgroundColor="#FFFFFF"
Square150x150Logo="images\squareTile-sdk.png"
Square44x44Logo="images\smallTile-sdk.png"
AppListEntry="default">
<uap:DefaultTile
ShowName="allLogos" />
<uap:LockScreen
Notification="badge"
BadgeLogo="images\badgeLogo.png" />
<uap:SplashScreen
BackgroundColor="white"
Image="images\splash-sdk.png" />
<uap:InitialRotationPreference>
<uap:Rotation
Preference="portrait" />
</uap:InitialRotationPreference>
</uap:VisualElements>
</Application>
</Applications>
Vedi anche
- Immagini e screenshot delle app
- Classe Colors
- Avvio rapido: Creazione di un riquadro predefinito usando l'editor manifesto di Visual Studio
Requisiti
| Elemento | Valore |
|---|---|
| Namespace | http://schemas.microsoft.com/appx/manifest/uap/windows10 |
| Minimum OS Version | Windows 10 versione 1511 (Build 10586) |
Commenti e suggerimenti
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedere https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per