InitialRotationPreference (schéma de package pour Windows 8)

Article
07/20/2023

Décrit les orientations dans lesquelles l’application préfère être affichée pour une expérience utilisateur optimale. Sur un appareil qui peut être pivoté, par exemple une tablette, l’application ne sera pas redessinée pour les orientations qui ne sont pas spécifiées ici. Par exemple, si l’application spécifie uniquement des orientations paysage et LandscapeFlipped, et que l’appareil passe à l’orientation portrait, l’application ne pivote pas.

Notez que sur les appareils qui ne peuvent pas être pivotés, une application peut être affichée dans l’orientation par défaut de l’appareil et l’orientation préférée de l’application sera ignorée. Toutefois, sur un appareil avec un verrou de rotation activé, la rotation préférée de votre application sera toujours respectée.

Ces choix d’orientation s’appliquent à la fois à l' écran de démarrage et à l’interface utilisateur de l’application lorsqu’une nouvelle session est lancée pour votre application. Les préférences peuvent être modifiées au moment de l’exécution via la propriété AutoRotationPreferences .

Hiérarchie d’éléments

<Packages>

<Applications>

<Application>

<VisualElements>: <InitialRotationPreference>

Syntaxe

<InitialRotationPreference>

  <!-- Child elements -->
  Rotation{1,4}

</InitialRotationPreference>

Clé

{} plage spécifique d’occurrences

Attributs et éléments

Attributs

Aucun.

Éléments enfants

Élément enfant	Description
Rotation	Spécifie une orientation de rotation unique dans laquelle une application s’affiche.

Éléments parents

Élément parent	Description
VisualElements	Décrit les aspects visuels de l’application UWP : sa vignette par défaut, les images de logo, le texte et les couleurs d’arrière-plan, l’orientation initiale de l’écran, l’écran de démarrage et l’apparence de la vignette de l’écran de verrouillage.

Notes

Cet élément fait partie du fichier manifeste de votre application (package. appxmanifest). dans l’éditeur de manifeste Microsoft Visual Studio, ce paramètre se trouve sous l’onglet interface utilisateur de l’Application en tant que « rotations initiales prises en charge ». Par défaut, aucune des options n’est sélectionnée. Cela signifie que toutes les orientations de rotation sont prises en charge. Si vous sélectionnez aucune rotation ou toutes les rotations, vous obtenez le même résultat.

Étant donné que votre application peut être exécutée sur différents types d’appareils (PC de bureau, tablettes, ordinateurs portables ou téléphones), vous ne pouvez pas être assuré d’avoir une connaissance préalable de l’orientation de l’appareil au moment où votre application est lancée, ni de la rotation de l’appareil pendant que l’application est active. Par conséquent, nous vous recommandons de développer votre application avec la possibilité d’être affichée dans n’importe quelle orientation. cela dit, votre application peut utiliser cet élément pour demander à Windows de limiter l’affichage de votre application à ses rotations idéales. toutefois, Windows ne peut pas toujours honorer la requête. Comme tous les appareils ne peuvent pas pivoter ou ne pas détecter la rotation, les préférences d’orientation ne peuvent pas toujours être respectées par Windows. Par exemple, si vous indiquez que votre application doit être affichée en mode portrait mais que l’application est exécutée sur un moniteur de bureau orienté paysage standard ou sur une télévision, la préférence sera ignorée car l’affichage de l’application de son côté serait une expérience utilisateur médiocre. Pour cette raison, vous devez envisager de prendre en charge toutes les orientations afin que votre application semble correcte quelle que soit la rotation de l’appareil.

Remarque À ce moment-là, les PC de bureau et les Notebooks restent les appareils les plus prédominants sur lesquels votre application est susceptible d’être exécutée, et étant donné que ces appareils sont presque tous corrigés dans une orientation paysage et ne détectent pas la rotation, il est nécessaire qu’une application prenne en charge au moins la rotation du paysage. Toutefois, même s’il doit être pris en charge, vous n’êtes pas obligé de déclarer le paysage comme une rotation par défaut.

Cet élément contient jusqu’à 4 éléments de rotation , chacun d’entre eux spécifiant une orientation dans laquelle l’application préfère être affichée. Si vous n’incluez pas d’éléments de rotation , cela a le même effet que les quatre.

L’exemple suivant montre une application qui s’affiche en mode paysage et LandscapeFlipped, mais ne modifie pas son orientation pour un appareil détenu en portrait ou PortraitFlipped.

                        
<InitialRotationPreference>
    <Rotation Preference="landscape"/>
    <Rotation Preference="landscapeFlipped"/>
</InitialRotationPreference>

lorsque votre application est lancée pour la première fois, Windows reçoit ses préférences de rotation. Ces préférences restent en place jusqu’à ce que l’application soit terminée, avec une exception importante : si un appel est effectué pour Windows. Graphics. Display. DisplayProperties. autoRotationPreferences pour modifier ces préférences. cette API est utilisée pour informer Windows d’une modification des préférences de rotation de votre application et peut être appelée à tout moment. Notez que cet appel d’API n’affecte pas le contenu de l’élément InitialRotationPreference dans le fichier manifeste de l’application, qui reste à mesure que vous les définissez dans l’éditeur de manifeste. Par conséquent, chaque fois que vous relancez votre application, elle prend les préférences de rotation que vous avez spécifiées à l’origine dans le manifeste de votre application.

Par exemple, Imaginez une application de jeu qui est mieux affichée en mode paysage, mais qui contient une page qui affiche une carte qui est plus lisible en portrait. La série d’événements suivante peut se produire sur un appareil qui prend en charge la rotation. Une bonne connaissance des termes du cycle de vie des applications vous sera utile.

Le développeur spécifie les préférences de rotation paysage et/ou LandscapeFlipped pour l’application dans l’éditeur de manifeste.
Le jeu est installé et lancé. Les préférences spécifiées dans l’éditeur de manifeste s’appliquent et le jeu ne pivote pas en mode portrait.
Le jeu détecte que l’utilisateur accède à la carte. il appelle AutoRotationPreferences pour indiquer à Windows de modifier les préférences de rotation de l’application en Portrait et/ou PortraitFlipped.
Windows fait pivoter l’application vers la nouvelle orientation préférée.
L’utilisateur bascule vers une autre application pour vérifier son courrier.
L’utilisateur revient à l’application de jeu pour continuer là où elle s’était arrêtée. Windows sait que la dernière préférence indiquée par l’application était pour le mode Portrait et met l’application à l’écran dans cette orientation. Notez qu’il ne faisait pas référence aux paramètres InitialRotationPreference , car la session active est toujours active.
Le jeu détecte que l’utilisateur ferme la page de mappage. Il appelle AutoRotationPreferences pour rétablir ses préférences de rotation à ses paramètres de paysage d’origine pour continuer le jeu.
L’utilisateur termine le jeu et l’application est suspendue une fois que l’utilisateur a quitté la file d’attente pendant un certain laps de temps.
L’utilisateur reprend l’application pour qu’elle joue un autre jeu. Étant donné que l’application n’a pas été relancée, les dernières préférences déclarées par l’API AutoRotationPreferences s’appliquent toujours.
Le jeu est fermé (terminé).
Le jeu est redémarré. Étant donné qu’il commence à démarrer à partir d’un lancement initial, les paramètres InitialRotationPreference s’appliquent à nouveau.

Le point important à noter est qu’une fois que vous avez appelé AutoRotationPreferences, il vous incombe de gérer les préférences de rotation par le biais de cette API jusqu’à ce que le jeu soit terminé (et non simplement suspendu).

quand une application pivote, Windows le fait pivoter. Si vous fermez l’application en mode portrait, l’écran de démarrage s’affiche en mode portrait. Si une application a défini une préférence de rotation pour une rotation différente de celle que l’appareil affiche actuellement, la rotation du système se produit lorsque l’écran de démarrage de l’application s’affiche. L’interface utilisateur principale de l’application ne s’affiche pas tant que la rotation du système n’est pas terminée.

Voir aussi

VisualElements

démarrage rapide : création d’une vignette par défaut à l’aide de l’éditeur de manifeste Visual Studio

Windows. Graphics. Display. DisplayProperties. AutoRotationPreferences

Spécifications

	Valeur
Espace de noms	`http://schemas.microsoft.com/appx/2010/manifest`

Partager via