1# Window Subsystem Changelog
2
3## cl.window.1 Landscape Orientation Behavior Changed
4
5**Access Level**
6
7Public API
8
9**Reason for Change**
10
11When 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.
12
13**Change Impact**
14
15This change is a non-compatible change.
16
17This 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.
18
19The following figures show the comparison before and after the change.
20| Before Change | After Change |
21|---------|---------|
22| ![](figures/down.png) | ![](figures/up.png) |
23
24**Start API Level**
25
269
27
28**Change Since**
29
30OpenHarmony SDK 5.0.0.25
31
32**Key API/Component Changes**
33
34The following table lists the landscape settings before and after the change.
35
36Landscape effect comparison
37|Orientation| Before Change         | After Change  |
38|-------| -------- | --------------- |
39|LANDSCAPE|  Power button facing downwards   |  Power button facing upwards  |
40|LANDSCAPE_INVERTED|  Power button facing upwards   |  Power button facing downwards |
41|AUTO_ROTATION_LANDSCAPE|  Power button facing downwards   |  Power button facing upwards |
42|AUTO_ROTATION_LANDSCAPE_RESTRICTED|  Power button facing downwards   |  Power button facing upwards  |
43|USER_ROTATION_LANDSCAPE   |  Power button facing downwards  | Power button facing upwards  |
44|USER_ROTATION_LANDSCAPE_INVERTED|  Power button facing upwards |  Power button facing downwards  |
45
46**Adaptation Guide**
47
481. Change the enumerated values as follows:
49
50   (1) If **LANDSCAPE** is passed in before the change, pass in **LANDSCAPE_INVERTED** after the change to ensure the same experience.
51
52   (2) If **LANDSCAPE_INVERTED** is passed in before the change, pass in **LANDSCAPE** after the change to ensure the same experience.
53
54   (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.
55
56   (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.
57
582. The listened landscape orientation is changed.
59
60   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.
61
62   (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.
63
64   |Orientation| Before Change         | After Change  |
65   |-------| -------- | --------------- |
66   |LANDSCAPE|  1    |  3   |
67   |LANDSCAPE_INVERTED|  3    |  1  |
68   |AUTO_ROTATION_LANDSCAPE|  1    |  3 |
69   |AUTO_ROTATION_LANDSCAPE_RESTRICTED|  3    |  1   |
70   |USER_ROTATION_LANDSCAPE   |  1   | 3   |
71   |USER_ROTATION_LANDSCAPE_INVERTED|  3  |  1   |
72(2) When the power button is on the left side of the device, the values of **displayOrientation** remain unchanged before and after the change.
733. Recommended enumerated values for the landscape mode:
74
75   After the change, you are advised to set the landscape mode to **LANDSCAPE** and **USER_ROTATION_LANDSCAPE**.