harmony 鸿蒙窗口子系统变更说明

  • 2025-06-16
  • 浏览 (6)

窗口子系统变更说明

cl.window.1 优化getWindowProperties,增加返回值中drawableRect的实时性,调用行为变更

访问级别

公开接口

变更原因

应用调用getWindowProperties可以获取窗口属性,返回的结构体中表示可绘制区域的字段为drawableRect,如果在on(‘windowSizeChange’)回调中调用getWindowproperties,可能获得未更新的drawableRect。 通过本次变更,在on(‘windowSizeChange’)回调中同步更新windowRect和drawableRect,应用可基于此进行更加灵活的自绘制布局。

变更影响

该变更为不兼容变更。

变更前:on(‘windowSizeChange’)回调中调用getWindowProperties获取drawableRect,可能获得未更新的drawableRect。

变更后:on(‘windowSizeChange’)回调中调用getWindowProperties获取drawableRect,可以获得正确的drawableRect。

起始 API Level

11

变更发生版本

从OpenHarmony SDK 5.0.0.45开始。

变更的接口/组件

@ohos.window.d.ts

系统能力:SystemCapability.WindowManager.WindowManager.Core

接口:getWindowProperties

适配指导

drawableRect字段从API 11开始提供。

在API 11、API 12中,不建议使用该字段进行布局,可以基于windowRect进行布局。

在API 13及之后的版本,建议使用该字段进行布局,可以获得精准的布局效果。

你可能感兴趣的鸿蒙文章

harmony 鸿蒙ArkUI子系统Changelog

harmony 鸿蒙元能力子系统Changelog

0  赞