1e41f4b71Sopenharmony_ci# Window Subsystem Changelog 2e41f4b71Sopenharmony_ci 3e41f4b71Sopenharmony_ci## cl.window.1 Landscape Orientation Behavior Changed 4e41f4b71Sopenharmony_ci 5e41f4b71Sopenharmony_ci**Access Level** 6e41f4b71Sopenharmony_ci 7e41f4b71Sopenharmony_ciPublic API 8e41f4b71Sopenharmony_ci 9e41f4b71Sopenharmony_ci**Reason for Change** 10e41f4b71Sopenharmony_ci 11e41f4b71Sopenharmony_ciWhen setting the landscape mode for an application by configuring the ability tag **orientation** in the **module.json** file or calling the **setPreferredOrientation** API, developers are used to choosing **LANDSCAPE**. In this case, the power button rotates to the bottom of the device, which is opposite to the common logic in the industry and does not comply with user habits. 12e41f4b71Sopenharmony_ci 13e41f4b71Sopenharmony_ci**Change Impact** 14e41f4b71Sopenharmony_ci 15e41f4b71Sopenharmony_ciThis change is a non-compatible change. 16e41f4b71Sopenharmony_ci 17e41f4b71Sopenharmony_ciThis change takes effect from OpenHarmony SDK 5.0.0.25 (API version 12). It does not take effect in API version 11 and earlier versions. After the change, the rotation orientation is opposite to that before the change when **LANDSCAPE** is applied. 18e41f4b71Sopenharmony_ci 19e41f4b71Sopenharmony_ciThe following figures show the comparison before and after the change. 20e41f4b71Sopenharmony_ci| Before Change | After Change | 21e41f4b71Sopenharmony_ci|---------|---------| 22e41f4b71Sopenharmony_ci|  |  | 23e41f4b71Sopenharmony_ci 24e41f4b71Sopenharmony_ci**Start API Level** 25e41f4b71Sopenharmony_ci 26e41f4b71Sopenharmony_ci9 27e41f4b71Sopenharmony_ci 28e41f4b71Sopenharmony_ci**Change Since** 29e41f4b71Sopenharmony_ci 30e41f4b71Sopenharmony_ciOpenHarmony SDK 5.0.0.25 31e41f4b71Sopenharmony_ci 32e41f4b71Sopenharmony_ci**Key API/Component Changes** 33e41f4b71Sopenharmony_ci 34e41f4b71Sopenharmony_ciThe following table lists the landscape settings before and after the change. 35e41f4b71Sopenharmony_ci 36e41f4b71Sopenharmony_ciLandscape effect comparison 37e41f4b71Sopenharmony_ci|Orientation| Before Change | After Change | 38e41f4b71Sopenharmony_ci|-------| -------- | --------------- | 39e41f4b71Sopenharmony_ci|LANDSCAPE| Power button facing downwards | Power button facing upwards | 40e41f4b71Sopenharmony_ci|LANDSCAPE_INVERTED| Power button facing upwards | Power button facing downwards | 41e41f4b71Sopenharmony_ci|AUTO_ROTATION_LANDSCAPE| Power button facing downwards | Power button facing upwards | 42e41f4b71Sopenharmony_ci|AUTO_ROTATION_LANDSCAPE_RESTRICTED| Power button facing downwards | Power button facing upwards | 43e41f4b71Sopenharmony_ci|USER_ROTATION_LANDSCAPE | Power button facing downwards | Power button facing upwards | 44e41f4b71Sopenharmony_ci|USER_ROTATION_LANDSCAPE_INVERTED| Power button facing upwards | Power button facing downwards | 45e41f4b71Sopenharmony_ci 46e41f4b71Sopenharmony_ci**Adaptation Guide** 47e41f4b71Sopenharmony_ci 48e41f4b71Sopenharmony_ci1. Change the enumerated values as follows: 49e41f4b71Sopenharmony_ci 50e41f4b71Sopenharmony_ci (1) If **LANDSCAPE** is passed in before the change, pass in **LANDSCAPE_INVERTED** after the change to ensure the same experience. 51e41f4b71Sopenharmony_ci 52e41f4b71Sopenharmony_ci (2) If **LANDSCAPE_INVERTED** is passed in before the change, pass in **LANDSCAPE** after the change to ensure the same experience. 53e41f4b71Sopenharmony_ci 54e41f4b71Sopenharmony_ci (3) If **USER_ROTATION_LANDSCAPE** is passed in before the change, pass in **USER_ROTATION_LANDSCAPE_INVERTED** after the change to ensure the same experience. 55e41f4b71Sopenharmony_ci 56e41f4b71Sopenharmony_ci (4) If **USER_ROTATION_LANDSCAPE_INVERTED** is passed in before the change, pass in **USER_ROTATION_LANDSCAPE** after the change to ensure the same experience. 57e41f4b71Sopenharmony_ci 58e41f4b71Sopenharmony_ci2. The listened landscape orientation is changed. 59e41f4b71Sopenharmony_ci 60e41f4b71Sopenharmony_ci After the landscape mode is set for an application, the orientation of the display can be obtained by listening for **display.on('change')**. After the change, the orientation of the display changes accordingly when the display rotates. 61e41f4b71Sopenharmony_ci 62e41f4b71Sopenharmony_ci (1) When the power button is on the right side of the device, the values of **displayOrientation** are different before and after the change, as described below. 63e41f4b71Sopenharmony_ci 64e41f4b71Sopenharmony_ci |Orientation| Before Change | After Change | 65e41f4b71Sopenharmony_ci |-------| -------- | --------------- | 66e41f4b71Sopenharmony_ci |LANDSCAPE| 1 | 3 | 67e41f4b71Sopenharmony_ci |LANDSCAPE_INVERTED| 3 | 1 | 68e41f4b71Sopenharmony_ci |AUTO_ROTATION_LANDSCAPE| 1 | 3 | 69e41f4b71Sopenharmony_ci |AUTO_ROTATION_LANDSCAPE_RESTRICTED| 3 | 1 | 70e41f4b71Sopenharmony_ci |USER_ROTATION_LANDSCAPE | 1 | 3 | 71e41f4b71Sopenharmony_ci |USER_ROTATION_LANDSCAPE_INVERTED| 3 | 1 | 72e41f4b71Sopenharmony_ci(2) When the power button is on the left side of the device, the values of **displayOrientation** remain unchanged before and after the change. 73e41f4b71Sopenharmony_ci3. Recommended enumerated values for the landscape mode: 74e41f4b71Sopenharmony_ci 75e41f4b71Sopenharmony_ci After the change, you are advised to set the landscape mode to **LANDSCAPE** and **USER_ROTATION_LANDSCAPE**.
