文档开发者中心
我的
|

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 未知归属地
写回答
新增插入模板功能
一键使用模板,快速填写内容,轻松发帖~
知道了
  • 为了保障您的信息安全,请勿上传您的敏感个人信息(如您的密码等信息)和您的敏感资产信息(如关键源代码、签名私钥、调试安装包、业务日志等信息),且您需自行承担由此产生的信息泄露等安全风险。
  • 如您发布的内容为转载内容,请注明内容来源。

我要提问题

了解社区公约,与您携手共创和谐专业的开发者社区。