HarmonyOS开发者版主1|
ArkUI (方舟UI框架)
UI
HarmonyOS 5
HarmonyOS 如何设置强制应用横屏显示 (API12+)
HarmonyOS 如何设置强制应用横屏显示 (API12+)
1
浏览108 发布于2026-04-02 11:25未知归属地
全部评论
最多点赞
最新发布
最早发布

在HarmonyOS系统中,有两种方式可设置窗口的显示方向。
在module.json5文件中对orientation字段进行配置,该方式配置的是当应用启动时的窗口显示方向, 适用于在启动时就需要设置横屏或竖屏的应用。orientation字段支持的参数可参考窗口显示方向类型枚举。示例代码如下:
收起
自动换行
深色代码主题
复制
{
"module": {
// ...
"abilities": [
{
"name": "EntryAbility",
// ...
"orientation": "portrait" // 设置窗口为竖屏
}
]
}
}
在代码中通过调用窗口window的setPreferredOrientation 方法进行设置,该方式适用于在应用启动之后,还需要改变显示方向的场景。以视频类应用为例,此类应用在进入时为竖屏,而在视频播放页面可以显示为横屏,就需要支持用户临时修改窗口方向。假如在进入视频播放页时自动横屏,退出播放页则恢复竖屏显示,可采用window窗口提供的setPreferredOrientation方法将窗口显示方向修改为横屏、竖屏的状态。示例代码如下:
收起
自动换行
深色代码主题
复制
import { router, window } from '@kit.ArkUI';
import { BusinessError } from '@kit.BasicServicesKit';
@Entry
@Component
struct LandscapeScreen {
@State message: string = '横屏页面';
// 进入视频播放页面时设置横屏
onPageShow(): void {
let orientation = window.Orientation.LANDSCAPE
this.setScreenOrientation(orientation)
}
// 退出视频播放页面时设置竖屏
onPageHide(): void {
let orientation = window.Orientation.PORTRAIT
this.setScreenOrientation(orientation)
}
// 设置横竖屏的方法
setScreenOrientation(orientation: window.Orientation) {
let windowClass: window.Window | undefined = undefined;
try {
let promise = window.getLastWindow(getContext())
promise.then((data) => {
windowClass = data
windowClass.setPreferredOrientation(orientation)
}).catch((err: BusinessError) => {
console.error('getLastWindow error')
})
} catch (e) {
console.error('setScreenOrientation error')
}
}
build() {
Column() {
Text(this.message)
.fontSize(30)
.textAlign(TextAlign.Center)
.width('100%')
.fontWeight(500)
.height('50%')
.onClick(() => {
// 跳转index页面,验证取消横屏是否成功
router.pushUrl({ url: 'pages/Index' })
})
}
.justifyContent(FlexAlign.Center)
.width('100%')
.backgroundColor(Color.White)
.height('100%')
}
}
展开全部 
1楼回复于2026-04-02 11:25 未知归属地
写回答
新增插入模板功能
一键使用模板,快速填写内容,轻松发帖~
知道了
- 为了保障您的信息安全,请勿上传您的敏感个人信息(如您的密码等信息)和您的敏感资产信息(如关键源代码、签名私钥、调试安装包、业务日志等信息),且您需自行承担由此产生的信息泄露等安全风险。
- 如您发布的内容为转载内容,请注明内容来源。
我要提问题
相关推荐
换一批
1
HarmonyOS 横屏展示时,页面出现上一级页面信息,致使横屏展示当前页面无法铺满屏幕,如何解决?(API12+)
2
HarmonyOS 三折叠设置横屏自动旋转 (API12+)
3
HarmonyOS 平板横屏下左右空白(API12+)
4
如何设置横屏方向适配平板和折叠屏等多设备形态
5
HarmonyOS 折叠屏折叠后app被强制横屏 (API12+)
6
HarmonyOS 如何强制某个页面横屏显示(API12+)
7
HarmonyOS 如何在Pad上设置竖屏?(API12+)
8
HarmonyOS 如何实现应用切换成全屏状态 (API12+)
了解社区公约,与您携手共创和谐专业的开发者社区。




































苏公安网备 32011402010933号