1# 窗口子系统变更说明
2
3## cl.window.1 优化getWindowProperties,增加返回值中drawableRect的实时性,调用行为变更
4
5**访问级别**
6
7公开接口
8
9**变更原因**
10
11应用调用getWindowProperties可以获取窗口属性,返回的结构体中表示可绘制区域的字段为drawableRect,如果在on('windowSizeChange')回调中调用getWindowproperties,可能获得未更新的drawableRect。
12通过本次变更,在on('windowSizeChange')回调中同步更新windowRect和drawableRect,应用可基于此进行更加灵活的自绘制布局。
13
14**变更影响**
15
16该变更为不兼容变更。
17
18变更前:on('windowSizeChange')回调中调用getWindowProperties获取drawableRect,可能获得未更新的drawableRect。
19
20变更后:on('windowSizeChange')回调中调用getWindowProperties获取drawableRect,可以获得正确的drawableRect。
21
22**起始 API Level**
23
2411
25
26**变更发生版本**
27
28从OpenHarmony SDK 5.0.0.45开始。
29
30**变更的接口/组件**
31
32@ohos.window.d.ts
33
34系统能力:SystemCapability.WindowManager.WindowManager.Core
35
36接口:getWindowProperties
37
38**适配指导**
39
40drawableRect字段从API 11开始提供。
41
42在API 11、API 12中,不建议使用该字段进行布局,可以基于windowRect进行布局。
43
44在API 13及之后的版本,建议使用该字段进行布局,可以获得精准的布局效果。