uap3:VisualElements (Windows 10)

Artículo
05/03/2024

Describe los aspectos visuales de la aplicación: su icono predeterminado, imágenes de logotipo, colores de texto y fondo, orientación inicial de la pantalla, pantalla de presentación y apariencia del icono de pantalla de bloqueo.

Jerarquía de elemento

<uap3:VisualElements>

Syntax

<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>

Clave

? conector opcional (cero o uno) & intercalado (puede producirse en cualquier orden)

Atributos y elementos

Atributos

Atributo	Descripción	Tipo de datos	Obligatorio
DisplayName	Nombre descriptivo de la aplicación que se puede mostrar a los usuarios. Esta cadena es localizable; vea Comentarios para obtener más información.	Cadena con un valor entre 1 y 256 caracteres de longitud. Esta cadena se puede localizar.	Sí
Descripción	Descripción de la aplicación. Esta cadena es localizable; vea Comentarios para obtener más información.	Cadena entre 1 y 2048 caracteres de longitud.	Sí
BackgroundColor	Especifica el color de fondo del icono de la aplicación.	Número hexadecimal de tres bytes precedido por `#` o un color con nombre. Vea Comentarios para obtener una lista de colores con nombre.	Sí
Square150x150Logo	Imagen que se usa como icono medio de pantalla de inicio de la aplicación y en el conmutador de tareas. Para obtener más información sobre cómo especificar la imagen en este atributo, vea Comentarios.	Cadena con un valor de entre 1 y 256 caracteres de longitud que termina con , o que no puede contener estos caracteres: `<`, `>\|:"`, `?`, o .`*.jpeg.png.jpg` En esta cadena, los `/` caracteres y `\` no pueden ser los primeros o últimos caracteres. Además, la cadena puede contener `/` o `\` pero no ambas.	Sí
Square44x44Logo	Imagen que se usa como icono pequeño de pantalla de inicio de la aplicación y en la lista todas las aplicaciones. Para obtener más información sobre cómo especificar la imagen en este atributo, vea Comentarios.	Cadena con un valor de entre 1 y 256 caracteres de longitud que termina con , o que no puede contener estos caracteres: `<`, `>\|:"`, `?`, o .`*.jpeg.png.jpg` En esta cadena, los `/` caracteres y `\` no pueden ser los primeros o últimos caracteres. Además, la cadena puede contener `/` o `\` pero no ambas.	Sí
AppListEntry	Entrada en la lista todas las aplicaciones.	Cadena opcional que puede tener uno de los siguientes valores: predeterminado o ninguno.	No
VisualGroup	Nombre de una carpeta que se va a crear en la lista todas las aplicaciones, en la que se debe almacenar el icono de la aplicación.	Cadena con un valor entre 1 y 256 caracteres de longitud que no contiene barras diagonales inversas (`\`) o espacios.	No

Nota

El color de fondo especificado aquí también se aplica a estos elementos:

Color del botón en los cuadros de diálogo propiedad de la aplicación.
Página Descripción de la aplicación en la Tienda.

Elementos secundarios

Elemento secundario	Descripción
uap:DefaultTile	Define el icono predeterminado que representa la aplicación en la pantalla Inicio. Este icono se muestra cuando la aplicación se instala por primera vez, antes de recibir notificaciones de actualización. Cuando un icono no tiene notificaciones para mostrarse, el icono se revierte a este valor predeterminado.
uap:LockScreen	Define el distintivo y las notificaciones que representan la aplicación en la pantalla de bloqueo, que se muestra cuando el sistema está bloqueado.
uap:SplashScreen	Define la apariencia de la pantalla de presentación, que muestra la aplicación durante el inicio.
uap:InitialRotationPreference	Describe las orientaciones en las que la aplicación prefiere mostrarse para obtener la mejor experiencia de usuario.

Elementos primarios

Elemento primario	Descripción
Aplicación	Representa una aplicación que consta de parte o de toda la funcionalidad que se entrega en el paquete.

Comentarios

No puede usar el atributo VisualGroup para crear una estructura de carpetas anidadas. Si incluye una barra diagonal inversa (\) en el valor , se produce un error.

El atributo VisualGroup no es válido si el manifiesto declara solo una aplicación.

Para obtener más información sobre los requisitos de dimensión de icono, consulta Tamaños de icono.

Para las imágenes Square150x150Logo y Square44x44Logo , puedes proporcionar imágenes de diferentes escalas para que Windows pueda elegir el mejor tamaño para el dispositivo y la resolución de pantalla. También puedes proporcionar imágenes de contraste alto para accesibilidad e imágenes localizadas para que coincidan con diferentes idiomas de interfaz de usuario. Esta característica también permite localizar los atributos DisplayName y Description . Para obtener más información, consulta los temas globalización y localización del manifiesto del paquete .

Los requisitos de tamaño de dos tipos de imágenes de logotipo se muestran aquí:

Atributo de imagen	Escala (tamaño de imagen en píxeles)
`Applications/Application/VisualElements/@Square150x150Logo`	100 (150x150)
	250 (375x375)
`Applications/Application/VisualElements/@Square44x44Logo`	100 (44 x 44)
	250 (110x110)
`Applications/Application/VisualElements/@Tall150x310Logo`	100 (150x310)
	250 (375x775)

Estos son los nombres de color de fondo admitidos:

aliceBlue
antiqueWhite
aqua
aquamarine
azure
beige
bisque
black
blanchedAlmond
blue
blueViolet
brown
burlyWood
cadetBlue
chartreuse
chocolate
coral
cornflowerBlue
cornsilk
crimson
cyan
darkBlue
darkCyan
darkGoldenrod

darkGray
darkGreen
darkKhaki
darkMagenta
darkOliveGreen
darkOrange
darkOrchid
darkRed
darkSalmon
darkSeaGreen
darkSlateBlue
darkSlateGray
darkTurquoise
darkViolet
deepPink
deepSkyBlue
dimGray
dodgerBlue
firebrick
floralWhite
forestGreen
fuchsia
gainsboro
ghostWhite

gold
goldenrod
gray
green
greenYellow
honeydew
hotPink
indianRed
indigo
ivory
khaki
lavender
lavandaBlush
lawnGreen
lemonChiffon
lightBlue
lightCoral
lightCyan
lightGoldenrodYellow
lightGray
lightGreen
lightPink
lightSalmon
lightSeaGreen

lightSkyBlue
lightSlateGray
lightSteelBlue
lightYellow
lime
limeGreen
linen
magenta
maroon
mediumAquamarine
mediumBlue
mediumOrchid
mediumPurple
mediumSeaGreen
mediumSlateBlue
mediumSpringGreen
mediumTurquoise
mediumVioletRed
medianocheBlue
mintCream
mistyRose
moccasin
navajoWhite

navy
oldLace
olive
oliveDrab
orange
orangeRed
orchid
paleGoldenrod
paleGreen
paleTurquoise
paleVioletRed
calvinWhip
peachPuff
peru
pink
plum
powderBlue
purple
rojo
rosyBrown
Royalblue
saddleBrown
salmon

sandyBrown
seaGreen
Seashell
sienna
silver
Skyblue
slateBlue
slateGray
snow
springGreen
Steelblue
tan
teal
thistle
tomato
transparent
turquoise
violet
wheat
blanco
Whitesmoke
yellow
Amarillo-verde

Ejemplos

En el ejemplo siguiente se crea una carpeta denominada App1 en la lista todas las aplicaciones y se almacena el icono de App1 en esa carpeta.

<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>

Requisitos

Elemento	Value
Espacio de nombres	`http://schemas.microsoft.com/appx/manifest/uap/windows10/3`
Minimum OS Version	Windows 10 versión 1607 (compilación 14393)

Compartir a través de

uap3:VisualElements (Windows 10)

Jerarquía de elemento

Syntax

Clave

Atributos y elementos

Atributos

Elementos secundarios

Elementos primarios

Comentarios

Ejemplos

Requisitos

Comentarios

Recursos adicionales

Compartir a través de

uap3:VisualElements (Windows 10)

Jerarquía de elemento

Syntax

Clave

Atributos y elementos

Atributos

Elementos secundarios

Elementos primarios

Comentarios

Ejemplos

Temas relacionados

Requisitos

Comentarios

Recursos adicionales