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 :
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.
