详解鸿蒙Next仓颉开发语言中的全屏模式

原创

幽蓝计划

发布于 2025-06-19 11:01:57

2210

大家好，今天跟大家分享一下仓颉开发语言中的全屏模式。

和ArkTS一样，仓颉的新建项目默认是非全屏模式的，如果你的应用颜色比较丰富，就会发现屏幕上方和底部的留白，这是应用自动避让了屏幕上方摄像头区域和底部的导航条区域。

但是通常我们不需要这些留白，而是希望应用占满整个屏幕，这时候需要用到沉浸模式，下面为大家分享具体的实现过程。

首先，来到应用的main_ability.cj文件的onWindowStageCreate方法下，设置全屏模式我们要先获取到主窗口，然后设置全屏，实现代码如下：

windowStage.getMainWindow().setWindowLayoutFullScreen(true)

这时候运行程序，你会发现屏幕已经被应用占满了。但是新的问题出现了，你不让系统自动避让的话，就要自己避让上下方的摄像头和导航条区域。

要避让这些区域，首先要知道它们的尺寸，主要是高度。还是在刚才的方法中，获取顶部避让区域的方法如下：

let topArea = windowStage.getMainWindow().getWindowAvoidArea(AvoidAreaType.TYPE_SYSTEM)
let topAreaHeight = topArea.topRect.height

topAreaHeight就是顶部避让区域的高度尺寸，底部避让区域的获取方式稍有不同，需要单独获取：

let bottomArea = windowStage.getMainWindow().getWindowAvoidArea(AvoidAreaType.TYPE_NAVIGATION_INDICATOR)
let bottomAreaHeight = bottomArea.bottomRect.height

然后你可以将topAreaHeight和bottomAreaHeight保存，在应用其他地方获取使用：

AppStorage.setOrCreate('topHeight',topAreaHeight.toString())
AppStorage.setOrCreate('bottomHeight',bottomAreaHeight.toString())

这里大家尽量保存字符串类型，因为幽蓝君在使用Int64类型的时候遇到了问题。

这样的话就会得到一个占满屏幕又不被遮挡的应用。

另外，有些情况下大家可能会需要用到屏幕的尺寸，获取屏幕尺寸的方法如下：

let windowRect =  windowStage.getMainWindow().getWindowProperties().windowRect
AppLog.info('屏幕宽度:'+ windowRect.width.toString())
AppLog.info('屏幕高度:'+ windowRect.height.toString())

最后要注意，以上代码获取到的尺寸单位都是px，大家使用的时候要按需转换。

今天的内容就是这些，感谢阅读。##HarmonyOS语言##仓颉##购物#

原创声明：本文系作者授权腾讯云开发者社区发表，未经许可，不得转载。

如有侵权，请联系 cloudcommunity@tencent.com 删除。

harmonyos

原创声明：本文系作者授权腾讯云开发者社区发表，未经许可，不得转载。

如有侵权，请联系 cloudcommunity@tencent.com 删除。

harmonyos

登录后参与评论

0 条评论

热度

详解鸿蒙Next仓颉开发语言中的全屏模式

详解鸿蒙Next仓颉开发语言中的全屏模式

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐