Gdy automatyczna orientacja jest włączona, a użytkownik obraca urządzenie, system operacyjny zmienia orientację całego interfejsu użytkownika, łącznie z systemowym paskiem zadań i aplikacją. W rezultacie proporcje stołu montażowego zmieniają się z poziomych na pionowe lub z pionowych na poziome. Gdy zmieniają się proporcje, zmieniają się również wymiary stołu montażowego.
Automatyczną orientację można włączać lub wyłączać podczas działania, ustawiając dla właściwości
autoOrients
obiektu Stage wartość
true
lub
false
. Wartość początkową tej właściwości można określić w deskryptorze aplikacji AIR za pomocą elementu
<autoOrients>
. (W wersjach środowiska AIR wcześniejszych niż 2.6 właściwość
autoOrients
jest przeznaczona tylko do odczytu i można ją ustawić wyłącznie w deskryptorze aplikacji).
W przypadku ustawienia proporcji poziomych lub pionowych i włączenia orientacji automatycznej środowisko AIR ogranicza działanie funkcji orientacji automatycznej do określonych proporcji.
Zmiany wymiarów stołu montażowego
Gdy zmieniają się wymiary stołu montażowego, jego zawartość jest skalowana oraz jest zmieniana jego pozycja, co określają właściwości
scaleMode
i
align
obiektu Stage. W większości przypadków opieranie się na automatycznym działaniu wynikającym z ustawień właściwości
scaleMode
obiektu Stage nie daje dobrych wyników. Zamiast tego należy zmienić układ lub ponownie narysować grafikę i składniki w taki sposób, aby były obsługiwane różne proporcje. (Wprowadzenie elastycznej logiki układu oznacza również, że aplikacja będzie lepiej działać na urządzeniach o różnych rozmiarach ekranu i proporcjach).
Poniższa ilustracja przedstawia skutki stosowania różnych ustawień właściwości
scaleMode
podczas obracania typowego urządzenia przenośnego.
Ilustracja przedstawia zachowanie skalowania występujące podczas obracania z proporcji poziomych do pionowych w różnych trybach skalowania. Obracanie z orientacji pionowej do poziomej daje podobne efekty.
Zdarzenia zmiany orientacji
Obiekt Stage wywołuje zdarzenia dwóch typów, za pomocą których można wykrywać zmiany orientacji w celu reagowania na nie. Po włączeniu automatycznej orientacji są wywoływane odnoszące się do stołu montażowego zdarzenia
resize
i
orientationChange
.
Zdarzenie
resize
jest najlepszym zdarzeniem, którego można użyć, gdy ekran jest utrzymywany w prawidłowym ustawieniu za pomocą automatycznej orientacji. Kiedy stół montażowy wywołuje zdarzenie
resize
, należy zmienić układ zawartości lub narysować ją ponownie odpowiednio do potrzeb. Zdarzenie
resize
jest wywoływane tylko wówczas, gdy dla trybu skalowania stołu montażowego zostanie ustawiona wartość
noScale
.
Zdarzenia
orientationChange
również można użyć do wykrywania zmian orientacji. Zdarzenie
orientationChange
jest wywoływane wyłącznie po włączeniu automatycznej orientacji.
Uwaga:
Na niektórych platformach dla urządzeń przenośnych przed wywołaniem zdarzeń resize lub orientationChange stół montażowy wywołuje zdarzenie
orientationChanging
, które można anulować. To zdarzenie jest obsługiwane tylko na niektórych platformach, dlatego należy unikać polegania na nim.