VisualElements (esquema de paquete para Windows 8)
Describe los aspectos visuales de la aplicación para UWP: 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
- <Paquete>
-
- <APLICACIONES>
-
- <Application>
- <VisualElements>
Syntax
<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>
Clave
? opcional (cero o uno)
& interleave connector (puede producirse en cualquier orden)
Atributos y elementos
Atributos
| Atributo | Descripción | Tipo de datos | Obligatorio | Valor predeterminado |
|---|---|---|---|---|
| BackgroundColor | Especifica el color de fondo del icono de la aplicación. Consulte la sección Comentarios para obtener nombres de color. Tenga en cuenta que el color de fondo especificado aquí también se aplica a estos elementos:
|
Número hexadecimal de tres bytes precedido por "#" o un color con nombre. | 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 que no pueden incluir caracteres como tabulaciones, retornos de carro y avance de línea. | Yes | |
| 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. Hay dos palabras reservadas explícitamente que no se pueden usar como DisplayName para las aplicaciones cargadas en el Microsoft Store: "NoUIEntryPoints" y "NoUIEntryPoints-DesignMode". Estos identificadores están reservados para ser utilizados por herramientas de desarrollo y conjuntos de pruebas. |
Cadena entre 1 y 256 caracteres de longitud. | Yes | |
| ForegroundText | Especifica el color de primer plano del icono de la aplicación.
|
Este atributo puede tener uno de los siguientes valores:
|
Yes | |
| Logotipo | Imagen usada como icono cuadrado de la aplicación. Para obtener más información sobre cómo especificar la imagen en este atributo, vea Comentarios. |
Cadena entre 1 y 256 caracteres de longitud que termina con ".jpg", ".png" o ".jpeg" que no pueden contener estos caracteres: <, : >, %, ", |, ?o *. En esta cadena, los caracteres / y \ no pueden ser los primeros o últimos caracteres. Además, la cadena puede contener / o \ pero no ambas. | Yes | |
| SmallLogo | Imagen pequeña que se muestra en la esquina del icono para identificar la aplicación. Para obtener más información sobre cómo especificar la imagen en este atributo, vea Comentarios.
|
Cadena entre 1 y 256 caracteres de longitud que termina con ".jpg", ".png" o ".jpeg" que no pueden contener estos caracteres: <, : >, %, ", |, ?o *. En esta cadena, los caracteres / y \ no pueden ser los primeros o últimos caracteres. Además, la cadena puede contener / o \ pero no ambas. | Yes | |
| ToastCapable | Un valor de true indica que la aplicación puede proporcionar notificaciones del sistema. El valor predeterminado es false. Si no desea que aparezcan notificaciones del sistema, no especifique un valor para este atributo. Tenga en cuenta que las aplicaciones no deben tomar decisiones sobre si se deben enviar notificaciones del sistema en función de este valor. |
boolean | No |
Elementos secundarios
| Elemento secundario | Descripción |
|---|---|
| DefaultTile | 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 mostrar, el icono vuelve a este valor predeterminado. |
| InitialRotationPreference | Describe las orientaciones en las que la aplicación prefiere mostrarse para obtener la mejor experiencia de usuario. En un dispositivo que se puede girar, como una tableta, la aplicación no se volverá a dibujar para las orientaciones que no se especifican aquí. Por ejemplo, si la aplicación especifica solo las orientaciones Horizontal y HorizontalFlipped, y el dispositivo se gira a una orientación vertical, la aplicación no girará. Tenga en cuenta que en los dispositivos que no se pueden rotar, es posible que una aplicación se muestre en la orientación predeterminada del dispositivo y se omitirá la orientación preferida de la aplicación. Sin embargo, en un dispositivo con un bloqueo de rotación activado, se seguirá cumpliendo la rotación preferida de la aplicación. Estas opciones de preferencia de orientación se aplican tanto a la [pantalla de presentación](element-splashscreen.md) como a la interfaz de usuario de la aplicación cuando se inicia una nueva sesión para la aplicación. Las preferencias se pueden cambiar durante el tiempo de ejecución a través de [AutoRotationPreferences](/uwp/api/Windows. Propiedad Graphics.Display.DisplayProperties). |
| 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. |
| SplashScreen | Define la apariencia de la pantalla de presentación, que muestra la aplicación durante el inicio. |
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
Para obtener más información sobre los requisitos de dimensión de mosaico, consulta Tamaños de icono.
Las imágenes logo y SmallLogo se pueden proporcionar como una ruta de acceso directa a un archivo de imagen o como un recurso. Si usas una referencia a recursos, puedes proporcionar imágenes de diferentes escalas para que Windows pueda elegir el tamaño óptimo según la resolución de pantalla y el dispositivo. 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, consulte el tema Globalización .
Applications/Application/Extensions/Extension/Extension/FileTypeAssociation/Logo Applications/Application/Extensions/Extension/Protocol/Logo
Los requisitos de tamaño de dos tipos de imágenes de logotipo se muestran aquí:
Tamaño de imagen Escalar imagen en píxeles Applications\Application\VisualElements\@Logo 100 150x150 140 210x210 180 270x270 Applications\Application\VisualElements\@SmallLogo 100 30x30 140 42x42 180 54x54
Estos son los nombres de color de fondo admitidos:
| Nombre | Nombre | Nombre | Nombre | Nombre | Nombre |
|---|---|---|---|---|---|
| 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 | lightGreen | lightGray | lightPink | lightSalmon | lightSeaGreen |
| lightSkyBlue | lightSlateGray | lightSteelBlue | lightYellow | lime | limeGreen |
| linen | magenta | maroon | mediumAquamarine | mediumBlue | mediumOrchid |
| mediumPurple | mediumSeaGreen | mediumSlateBlue | mediumSpringGreen | mediumTurquoise | mediumVioletRed |
| midnightBlue | mintCream | mistyRose | moccasin | navajoWhite | navy |
| oldLace | olive | oliveDrab | orange | orangeRed | orchid |
| paleGoldenrod | paleGreen | paleTurquoise | paleVioletRed | whip | 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
El ejemplo siguiente se toma del manifiesto del paquete de un ejemplo de 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>
Consulte también
Imágenes y capturas de pantalla de aplicación
Inicio rápido: Creación de un icono predeterminado mediante el editor de manifiestos Visual Studio
Requisitos
| Value | |
|---|---|
| Espacio de nombres | http://schemas.microsoft.com/appx/2010/manifest |
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de