VisualElements (esquema de extensiones para Windows 8.1)
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 de icono de pantalla de bloqueo.
Jerarquía de elemento
<VisualElements>
Sintaxis
<VisualElements DisplayName = A string between 1 and 256 characters in length. This string is localizable.
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
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. >
<!-- Child elements -->
( DefaultTile?
& LockScreen?
& SplashScreen
& InitialRotationPreference?
)
</VisualElements>
Clave
? opcional (cero o uno)
& conector de intercalación (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 ver los nombres de color. Tenga en cuenta que el color de fondo especificado aquí también se aplica a estos elementos:
Se aplica a Windows Phone: la elección de "transparente" hace que se utilice el color de acento del sistema. |
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 de entre 1 y 2048 caracteres de longitud que no puede incluir caracteres como tabulaciones, retornos de carro y avances de línea. | Sí | |
| 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 de entre 1 y 256 caracteres de longitud. Esta cadena se puede localizar. | Sí | |
| ForegroundText | Especifica el color de primer plano del icono de la aplicación. Se aplica a Windows Phone: la elección de "transparente" hace que se utilice el color de acento del sistema. |
Este atributo puede tener uno de los siguientes valores:
|
Sí | |
| Logotipo | Imagen que se usa 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 de entre 1 y 256 caracteres que termina con ".jpg", ".png" o ".jpeg" que no puede contener estos caracteres: <, >, :, ", |, ?, o *. En esta cadena, los caracteres / y \ no pueden ser el primer ni el último carácter. Además, la cadena puede contener / o \ pero no ambos. | Sí | |
| SmallLogo | Una 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. Se aplica a Windows Phone: Windows Phone no admite el logotipo pequeño en el icono. Solo se usa en la lista Aplicaciones. |
Cadena de entre 1 y 256 caracteres que termina con ".jpg", ".png" o ".jpeg" que no puede contener estos caracteres: <, >, :, ", |, ?, o *. En esta cadena, los caracteres / y \ no pueden ser el primer ni el último carácter. Además, la cadena puede contener / o \ pero no ambos. | Sí | |
| ToastCapable | Un valor true indica que la aplicación puede proporcionar notificaciones del sistema. El valor predeterminado es false. Si no desea que aparezcan las notificaciones del sistema, no especifique un valor para este atributo. Tenga en cuenta que las aplicaciones no deben tomar decisiones sobre si enviar notificaciones del sistema basadas en este valor. |
boolean | No |
Elementos secundarios
| Elemento secundario | Descripción |
|---|---|
| DefaultTile | Icono predeterminado que representa la aplicación en el 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 que 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 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 se muestra una aplicación en la orientación predeterminada de ese 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á respetando 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.DisplayInformation). |
| 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 la aplicación muestra durante el inicio. |
Elementos primarios
Este elemento más externo (documento) no puede estar incluido en ningún otro elemento.
Comentarios
Para obtener más información sobre los requisitos de dimensión de mosaico, consulte Tamaños de mosaico.
Las imágenes de Logotipo y SmallLogo se pueden dar 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 localización de los atributos DisplayNamey Description . Para más información, consulte el tema Globalización .
Applications/Application/Extensions/Extension/FileTypeAssociation/Logo Applications/Application/Extensions/Extension/Protocol/Logo
Aquí se muestran los requisitos de tamaño de dos tipos de imágenes de logotipo:
Atributo de imagen Scale Image size in pixels 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 | whWhite | aqua | aquamarine | azure | beige |
| bisque | black | aarondAlmond | blue | blueViolet | brown |
| burlyWood | azul azul | chartreuse | chocolate | coral | flowerBlue |
| cornsilk | crimson | cyan | darkBlue | darkCyan | darkGoldenrod |
| darkGray | darkGreen | darkKhki | darkMagenta | darkOliveGreen | darkOrange |
| darkOrchid | darkRed | darkSalmon | darkSeaGreen | darkSlateBlue | darkSlateGray |
| darkTurquoise | darkViolet | deepPink | deepSkyBlue | dimGray | azul azul |
| firebrick | white | forestGreen | fuchsia | gainsboro | ghostWhite |
| gold | goldenrod | gray | green | greenYellow | honeydew |
| hotPink | indianRed | indigo | ivory | khaki | lavender |
| ushblush | ygreen | chiffon | lightBlue | lightCoral | lightCyan |
| lightGoldenrodYellow | lightGreen | lightGray | lightPink | lightSalmon | lightSeaGreen |
| lightSkyBlue | lightSlateGray | lightSteelBlue | lightYellow | lime | limeGreen |
| linen | magenta | maroon | mediumAquaquaqua | mediumBlue | mediumOrchid |
| mediumPurple | mediumSeaGreen | mediumSlateBlue | mediumSpringGreen | mediumTurquoise | mediumVioletRed |
| midnightBlue | mintCream | mistyRose | moccasin | yjoWhite | navy |
| oldLace | olive | oliveDrab | orange | orangeRed | orchid |
| ygoldenrod | ygreen | yturquoise | yvioletRed | yyaWhip | peachPuff |
| peru | pink | plum | azul de la caja de seguridad | purple | rojo |
| rosyBrown | Royalblue | wnBrown | salmon | lugar de vida | 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 de 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 Visual Studio manifiesto
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