InitialRotationPreference (esquema de extensiones para Windows 8.1)
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, una aplicación podría mostrarse 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 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 la propiedad AutoRotationPreferences .
Jerarquía de elemento
- <VisualElements>
- <InitialRotationPreference>
Sintaxis
<InitialRotationPreference>
<!-- Child elements -->
Rotation{1,4}
</InitialRotationPreference>
Clave
{} intervalo específico de repeticiones
Atributos y elementos
Atributos
Ninguno.
Elementos secundarios
| Elemento secundario | Descripción |
|---|---|
| Rotación | Especifica una única orientación rotacional en la que se mostrará una aplicación. |
Elementos primarios
| Elemento primario | Descripción |
|---|---|
| VisualElements | 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. |
Comentarios
Este elemento forma parte del archivo de manifiesto de la aplicación (package.appxmanifest). En el editor Microsoft Visual Studio manifiesto, esta opción se encuentra en la pestaña Interfaz de usuario de la aplicación como "Rotaciones iniciales admitidas". De forma predeterminada, no se selecciona ninguna de las opciones. Esto significa que se admiten todas las orientaciones de rotación. Al seleccionar ninguna de las rotaciones o todas las rotaciones se produce el mismo resultado.
Dado que la aplicación se puede ejecutar en diferentes tipos de dispositivos (equipos de escritorio, tabletas, portátiles o teléfonos), no se le puede garantizar un conocimiento previo de la orientación del dispositivo en el momento en que se inicia la aplicación, ni que el dispositivo no se rotará mientras la aplicación esté activa. Por lo tanto, se recomienda desarrollar la aplicación con la capacidad de mostrarse en cualquier orientación. Dicho esto, la aplicación puede usar este elemento para Windows restringir la presentación de la aplicación a sus rotaciones ideales. Sin embargo, Windows no siempre puede respetar la solicitud. Dado que no todos los dispositivos se pueden girar o detectar la rotación, las preferencias de orientación no siempre se pueden respetar Windows. Por ejemplo, si indica que la aplicación debe mostrarse en Vertical, pero la aplicación se ejecuta en un monitor de escritorio estándar orientado al entorno o en una televisión, se omitirá la preferencia porque mostrar la aplicación en su lado sería una experiencia de usuario deficiente. Por este motivo, debe considerar la posibilidad de admitir todas las orientaciones para que la aplicación tenga un aspecto bueno, independientemente de la rotación del dispositivo.
Nota Dado que en este momento los equipos de escritorio y los cuadernos siguen siendo los dispositivos predominantes estadísticamente en los que es probable que se ejecute la aplicación, y dado que esos dispositivos están casi todos fijos en una orientación horizontal y no detectan la rotación, es necesario que una aplicación admita al menos la rotación horizontal. Sin embargo, aunque debe ser compatible, no es necesario declarar Horizontal como rotación preferida.
Este elemento contiene hasta 4 elementos Rotation , cada uno de los cuales especifica una orientación en la que la aplicación prefiere ser vista. Si no incluye ningún elemento Rotation , tiene el mismo efecto que incluir los cuatro.
En el ejemplo siguiente se muestra una aplicación que se mostrará en Horizontal y HorizontalFlipped, pero no cambiará su orientación para un dispositivo contenido en Vertical o VerticalFlipped.
<InitialRotationPreference>
<Rotation Preference="landscape"/>
<Rotation Preference="landscapeFlipped"/>
</InitialRotationPreference>
Cuando se inicia inicialmente la aplicación, Windows sus preferencias de rotación. Estas preferencias permanecen en su lugar hasta que se termina la aplicación, con una excepción importante: si se realiza una llamada a Windows. Graphics.Display.DisplayInformation.autoRotationPreferences para cambiar esas preferencias. Esa API se usa para informar a Windows de un cambio en las preferencias de rotación de la aplicación y se puede llamar a en cualquier momento. Tenga en cuenta que esta llamada API no afecta al contenido del elemento InitialRotationPreference en el archivo de manifiesto de la aplicación, que permanecen tal como se establecen en el editor de manifiestos. Por lo tanto, siempre que vuelva a iniciar la aplicación, toma las preferencias de rotación que especificó originalmente en el manifiesto de la aplicación.
Por ejemplo, considere una aplicación de juego que se vea mejor en Horizontal, pero que tenga una página determinada que muestre un mapa que sea más legible en Vertical. La siguiente serie de eventos podría tener lugar en un dispositivo que admita la rotación. Estar familiarizado con los términos del ciclo de vida de la aplicación le será útil aquí.
- El desarrollador especifica las preferencias de rotación horizontal o horizontal de la aplicación en el editor de manifiestos.
- El juego se instala e inicia. Se aplican las preferencias especificadas en el editor de manifiestos y el juego no girará en Vertical.
- El juego detecta que el usuario está accediendo al mapa. Llama a AutoRotationPreferences para Windows cambiar las preferencias de rotación de la aplicación a Vertical o VerticalFlipped.
- Windows la aplicación a la nueva orientación preferida.
- El usuario cambia a otra aplicación para comprobar su correo.
- El usuario vuelve a la aplicación de juego para continuar donde lo dejó. Windows sabe que la última preferencia indicada de la aplicación era vertical y pone la aplicación en pantalla en esa orientación. Tenga en cuenta que no hizo referencia a la configuración initialRotationPreference porque la sesión actual sigue activa.
- El juego detecta que el usuario está cerrando la página del mapa. Llama a AutoRotationPreferences para cambiar sus preferencias de rotación a su configuración horizontal original para continuar con el juego.
- El usuario finaliza el juego y la aplicación se suspende después de que el usuario se vaya durante un período de tiempo.
- El usuario reanuda la aplicación para jugar a otro juego. Dado que la aplicación no se ha reiniciado, se siguen aplicando las últimas preferencias declaradas por la API AutoRotationPreferences .
- El juego está cerrado (finalizado).
- El juego se reinicia. Dado que vuelve a empezar desde un inicio inicial, se vuelve a aplicar la configuración initialRotationPreference .
El punto clave a tener en cuenta es que, una vez que haya llamado a AutoRotationPreferences, es su responsabilidad controlar las preferencias de rotación a través de esa API hasta que finalice el juego (no simplemente suspendido).
Cuando una aplicación gira, Windows gira con ella. Si cierra la aplicación en Vertical, el pantalla Inicio se muestra en Vertical. Si una aplicación ha indicado una preferencia de rotación para una rotación diferente de la que muestra actualmente el dispositivo, la rotación del sistema se produce mientras se muestra la pantalla de presentación de la aplicación. La interfaz de usuario principal de la aplicación no se mostrará hasta que se complete la rotación del sistema detrás de ella.
Consulte también
Inicio rápido: Creación de un icono predeterminado mediante el editor Visual Studio manifiestos
Windows. Graphics.Display.DisplayInformation.AutoRotationPreferences
Requisitos
| Value | |
|---|---|
| Espacio de nombres | http://schemas.microsoft.com/appx/2010/manifest |