Orientation automatique

Si l’orientation automatique est activée et que l’utilisateur fait pivoter le périphérique, le système d’exploitation réoriente l’interface utilisateur entière, y compris la barre des tâches système et l’application. Le format de la scène passe du mode portrait au mode paysage, et vice versa. La modification du format entraîne également la modification des dimensions de la scène.

Pour activer ou désactiver l’orientation automatique lors de l’exécution, définissez la propriété autoOrients de l’objet Stage sur true ou false. Vous pouvez définir la valeur initiale de cette propriété dans le descripteur d’application AIR avec l’élément <autoOrients>. (Notez que dans les versions d’AIR antérieures à 2.6, autoOrients est une propriété disponible en lecture seule, que vous ne pouvez définir que dans le descripteur d’application.)

Si vous spécifiez le format paysage ou portrait et activez l’orientation automatique, AIR définit l’orientation automatique au format spécifié.

Modification des dimensions de la scène

En cas de modification des dimensions de la scène, le contenu de cette dernière est mis à l’échelle et repositionné comme stipulé par les propriétés scaleMode et align de l’objet Stage. Dans la plupart des cas, il n’est pas recommandé de se fier au comportement automatique défini par les paramètres scaleMode de l’objet Stage. Pour prendre en charge plusieurs formats, il est préférable de modifier la mise en forme des graphiques et des composants ou de rafraîchir ces derniers. (Une logique de mise en forme souple présente également l’avantage d’assurer un meilleur fonctionnement de l’application sur des périphériques aux tailles d’écran et formats distincts.)

L’illustration suivante présente les effets des différents paramètres scaleMode lors de la rotation d’un périphérique mobile standard :

Afficher le graphique en taille réelle
Rotation d’un format paysage vers un format portrait

Cette illustration décrit le comportement du périphérique lorsque l’utilisateur passe du mode paysage au mode portrait avec différents modes de mise à l’échelle. Le passage du mode portrait au mode paysage produit des effets similaires.

Evénements de changement d’orientation

L’objet Stage distribue deux types d’événements, dont vous disposez pour détecter les changements d’orientation et réagir à ces derniers. Les événements resize et orientationChange de la scène sont tous deux distribués si l’orientation automatique est activée.

Privilégiez l’événement resize si vous vous fiez à l’orientation automatique pour assurer une position verticale à l’affichage. Lorsque la scène distribue un événement resize, changez la disposition de votre contenu ou redessinez-le si nécessaire. L’événement resize n’est distribué que si le mode de mise à l’échelle de la scène est défini sur noScale.

L’événement orientationChange permet également de détecter les changements d’orientation. L’événement orientationChange n’est distribué que si l’orientation automatique est activée.

Remarque : sur certaines plates-formes mobiles, la scène distribue un événement orientationChanging, que vous pouvez annuler, avant de distribuer les événements resize ou orientationChange. Etant donné que cet événement n’est pas pris en charge sur toutes les plates-formes, évitez de trop vous y fier.