输入关键字搜索
开发者能力认证
鸿蒙高校创新赛
HarmonyOS 7
animation
HarmonyOS行业解决方案
layoutWeight
HarmonyOS模板&组件
bindPopup
bindsheet
CTRL+K
文档管理中心
输入关键字搜索
开发者能力认证
鸿蒙高校创新赛
HarmonyOS 7
animation
HarmonyOS行业解决方案
layoutWeight
HarmonyOS模板&组件
bindPopup
bindsheet
CTRL+K
  • 更多

oh_window_comm.h

更新时间: 2026-06-13 03:51
本文导读
展开章节

概述

PhonePC/2in1TabletTVWearable

提供窗口的公共枚举、公共定义等。

引用文件： <window_manager/oh_window_comm.h>

库： libnative_window_manager.so

系统能力： SystemCapability.Window.SessionManager

起始版本： 12

相关模块： WindowManager

汇总

PhonePC/2in1TabletTVWearable

结构体

PhonePC/2in1TabletTVWearable
展开
名称 typedef关键字 描述
WindowManager_Rect WindowManager_Rect 定义窗口矩形结构体，包含窗口位置和宽高信息。
OH_PixelmapNative OH_PixelmapNative 定义像素图片信息。
WindowManager_WindowProperties WindowManager_WindowProperties 窗口属性。
WindowManager_AvoidArea WindowManager_AvoidArea 定义避让区域结构体。
WindowManager_MainWindowInfo WindowManager_MainWindowInfo 主窗口信息。
WindowManager_WindowSnapshotConfig WindowManager_WindowSnapshotConfig 主窗口截图的配置项。
OH_WindowManager_FrameMetrics OH_WindowManager_FrameMetrics 帧率指标数据对象。
OH_WindowManager_DensityInfo OH_WindowManager_DensityInfo 窗口缩放系数相关信息，包括系统显示大小缩放系数、系统默认显示大小缩放系数、自定义显示大小缩放系数。

枚举

PhonePC/2in1TabletTVWearable
展开
名称 typedef关键字 描述
WindowManager_ErrorCode WindowManager_ErrorCode 窗口管理接口返回状态码枚举。
WindowManager_AvoidAreaType WindowManager_AvoidAreaType 避让区域枚举类型。
WindowManager_WindowType WindowManager_WindowType 窗口类型。

函数

PhonePC/2in1TabletTVWearable
展开
名称 typedef关键字 描述
typedef void (*OH_WindowManager_FrameMetricsMeasuredCallback)(int32_t windowId, const OH_WindowManager_FrameMetrics* metrics) OH_WindowManager_FrameMetricsMeasuredCallback 帧率指标回调类型。
typedef void (*OH_WindowManager_DensityInfoCallback)(int32_t windowId, const OH_WindowManager_DensityInfo* info) OH_WindowManager_DensityInfoCallback 窗口缩放系数相关信息回调类型。

枚举类型说明

PhonePC/2in1TabletTVWearable

WindowManager_ErrorCode

PhonePC/2in1TabletTVWearable
enum WindowManager_ErrorCode

描述

窗口管理接口返回状态码枚举。

起始版本： 12

展开
枚举项 描述
OK = 0 成功。
WINDOW_MANAGER_ERRORCODE_NO_PERMISSION = 201

无权限。

起始版本： 15
WINDOW_MANAGER_ERRORCODE_INVALID_PARAM = 401

非法参数。

起始版本： 15
WINDOW_MANAGER_ERRORCODE_DEVICE_NOT_SUPPORTED = 801

设备不支持。

起始版本： 15
INVAILD_WINDOW_ID = 1000 非法窗口ID。
SERVICE_ERROR = 2000 服务异常。
WINDOW_MANAGER_ERRORCODE_STATE_ABNORMAL = 1300002

窗口状态异常。

起始版本： 15
WINDOW_MANAGER_ERRORCODE_SYSTEM_ABNORMAL = 1300003

窗口管理器服务异常。

起始版本： 15
WINDOW_MANAGER_ERRORCODE_PIP_DESTROY_FAILED = 1300011

画中画销毁失败。

起始版本： 20
WINDOW_MANAGER_ERRORCODE_PIP_STATE_ABNORMAL = 1300012

画中画状态异常。

起始版本： 20
WINDOW_MANAGER_ERRORCODE_PIP_CREATE_FAILED = 1300013

画中画创建失败。

起始版本： 20
WINDOW_MANAGER_ERRORCODE_PIP_INTERNAL_ERROR = 1300014

画中画内部错误。可能原因：

1.画中画依赖的窗口异常，可能窗口为空；2.画中画控制器异常。

起始版本： 20
WINDOW_MANAGER_ERRORCODE_PIP_REPEATED_OPERATION = 1300015

画中画重复操作。

起始版本： 20
WINDOW_MANAGER_ERRORCODE_INCORRECT_PARAM = 1300016

参数错误。 可能原因：

1.参数取值范围非法；2.参数数量非法；3.参数类型非法。

起始版本： 20

WindowManager_AvoidAreaType

PhonePC/2in1TabletTVWearable
enum WindowManager_AvoidAreaType

描述

避让区域枚举类型。

起始版本： 15

展开
枚举项 描述
WINDOW_MANAGER_AVOID_AREA_TYPE_SYSTEM = 0 系统避让区域。
WINDOW_MANAGER_AVOID_AREA_TYPE_CUTOUT = 1 刘海屏避让。
WINDOW_MANAGER_AVOID_AREA_TYPE_SYSTEM_GESTURE = 2 系统手势区域。
WINDOW_MANAGER_AVOID_AREA_TYPE_KEYBOARD = 3 键盘区域。
WINDOW_MANAGER_AVOID_AREA_TYPE_NAVIGATION_INDICATOR = 4 导航条区域。

WindowManager_WindowType

PhonePC/2in1TabletTVWearable
enum WindowManager_WindowType

描述

窗口类型。

起始版本： 15

展开
枚举项 描述
WINDOW_MANAGER_WINDOW_TYPE_APP = 0 子窗口。
WINDOW_MANAGER_WINDOW_TYPE_MAIN = 1 主窗口。
WINDOW_MANAGER_WINDOW_TYPE_FLOAT = 8 全局悬浮窗口。
WINDOW_MANAGER_WINDOW_TYPE_DIALOG = 16 模态窗口。

函数说明

PhonePC/2in1TabletTVWearable

OH_WindowManager_FrameMetricsMeasuredCallback()Beta

PhonePC/2in1TabletTVWearable
typedef void (*OH_WindowManager_FrameMetricsMeasuredCallback)(
    int32_t windowId, const OH_WindowManager_FrameMetrics* metrics)

描述

帧率指标回调类型。

起始版本： 26.0.0

OH_WindowManager_DensityInfoCallback()

PhonePC/2in1TabletTVWearable
typedef void (*OH_WindowManager_DensityInfoCallback)(int32_t windowId, const OH_WindowManager_DensityInfo* info)

描述

窗口缩放系数相关信息回调类型。

起始版本： 24

简体中文
搜索
请输入您想要搜索的关键词