1# oh_window.h 2<!--Kit: ArkUI--> 3<!--Subsystem: Window--> 4<!--Owner: @waterwin--> 5<!--Designer: @nyankomiya--> 6<!--Tester: @qinliwen0417--> 7<!--Adviser: @ge-yafang--> 8 9## 概述 10 11定义窗口管理的相关接口，主要用于设置和获取指定窗口的属性，以及设置指定窗口的状态栏样式、导航栏样式。 12 13**引用文件：** <window_manager/oh_window.h> 14 15**库：** libnative_window_manager.so 16 17**系统能力：** SystemCapability.Window.SessionManager 18 19**起始版本：** 15 20 21**相关模块：** [WindowManager](capi-windowmanager.md) 22 23## 汇总 24 25### 函数 26 27| 名称 | 描述 | 28| -- | -- | 29| [int32_t OH_WindowManager_SetWindowStatusBarEnabled(int32_t windowId, bool enabled, bool enableAnimation)](#oh_windowmanager_setwindowstatusbarenabled) | 设置指定窗口是否显示状态栏。 | 30| [int32_t OH_WindowManager_SetWindowStatusBarColor(int32_t windowId, int32_t color)](#oh_windowmanager_setwindowstatusbarcolor) | 设置指定窗口的状态栏内容颜色。 | 31| [int32_t OH_WindowManager_SetWindowNavigationBarEnabled(int32_t windowId, bool enabled, bool enableAnimation)](#oh_windowmanager_setwindownavigationbarenabled) | 设置指定窗口是否显示导航栏。 | 32| [int32_t OH_WindowManager_GetWindowAvoidArea(int32_t windowId, WindowManager_AvoidAreaType type, WindowManager_AvoidArea* avoidArea)](#oh_windowmanager_getwindowavoidarea) | 获取指定窗口的避让区域。 | 33| [int32_t OH_WindowManager_IsWindowShown(int32_t windowId, bool* isShow)](#oh_windowmanager_iswindowshown) | 判断指定窗口是否显示。 | 34| [int32_t OH_WindowManager_ShowWindow(int32_t windowId)](#oh_windowmanager_showwindow) | 显示指定窗口。 | 35| [int32_t OH_WindowManager_SetWindowTouchable(int32_t windowId, bool isTouchable)](#oh_windowmanager_setwindowtouchable) | 设置指定窗口是否可触。 | 36| [int32_t OH_WindowManager_SetWindowFocusable(int32_t windowId, bool isFocusable)](#oh_windowmanager_setwindowfocusable) | 设置指定窗口是否可获焦。 | 37| [int32_t OH_WindowManager_SetWindowBackgroundColor(int32_t windowId, const char* color)](#oh_windowmanager_setwindowbackgroundcolor) | 设置指定窗口背景颜色。 | 38| [int32_t OH_WindowManager_SetWindowBrightness(int32_t windowId, float brightness)](#oh_windowmanager_setwindowbrightness) | 设置指定窗口的屏幕亮度。 | 39| [int32_t OH_WindowManager_SetWindowKeepScreenOn(int32_t windowId, bool isKeepScreenOn)](#oh_windowmanager_setwindowkeepscreenon) | 设置指定窗口是否开启屏幕常亮。 | 40| [int32_t OH_WindowManager_SetWindowPrivacyMode(int32_t windowId, bool isPrivacy)](#oh_windowmanager_setwindowprivacymode) | 设置指定窗口是否开启隐私模式。 | 41| [int32_t OH_WindowManager_GetWindowProperties(int32_t windowId, WindowManager_WindowProperties* windowProperties)](#oh_windowmanager_getwindowproperties) | 获取指定窗口属性。 | 42| [int32_t OH_WindowManager_Snapshot(int32_t windowId, OH_PixelmapNative* pixelMap)](#oh_windowmanager_snapshot) | 获取指定窗口截图。 | 43| [int32_t OH_WindowManager_GetAllWindowLayoutInfoList(int64_t displayId,WindowManager_Rect** windowLayoutInfoList, size_t* windowLayoutInfoSize)](#oh_windowmanager_getallwindowlayoutinfolist) | 获取指定屏幕上可见的窗口布局信息数组，按当前窗口层级排列，层级最高的对应数组下标为0。 | 44| [void OH_WindowManager_ReleaseAllWindowLayoutInfoList(WindowManager_Rect* windowLayoutInfoList)](#oh_windowmanager_releaseallwindowlayoutinfolist) | 释放窗口布局信息数组占用的内存。 | 45| [int32_t OH_WindowManager_InjectTouchEvent(int32_t windowId, Input_TouchEvent* touchEvent, int32_t windowX, int32_t windowY)](#oh_windowmanager_injecttouchevent) | 将多模触摸事件注入给目标窗口，仅支持注入同进程窗口，且该注入不会触发窗口焦点和层级变化，不会触发窗口拖拽，事件会直接发送给ArkUI。该接口需要在指定窗口加载UI之后调用。 | 46 47## 函数说明 48 49### OH_WindowManager_SetWindowStatusBarEnabled() 50 51``` 52int32_t OH_WindowManager_SetWindowStatusBarEnabled(int32_t windowId, bool enabled, bool enableAnimation) 53``` 54 55**描述** 56 57设置指定窗口是否显示状态栏。 58 59**起始版本：** 15 60 61 62**参数：** 63 64| 参数项 | 描述 | 65| -- | -- | 66| int32_t windowId | 创建窗口时的窗口id。默认值为0。该参数为整数。 | 67| bool enabled | 设置状态栏是否显示。true表示设置状态栏显示，false表示设置状态栏隐藏。 | 68| bool enableAnimation | 设置是否开启状态栏的显隐动画。true表示开启状态栏的显隐动画，false表示关闭状态栏的显隐动画。 | 69 70**返回：** 71 72| 类型 | 说明 | 73| -- | -- | 74| int32_t | 返回结果代码。<br> 返回OK，表示函数调用成功。<br> 返回WINDOW_MANAGER_ERRORCODE_INVALID_PARAM，表示参数错误。<br> 返回WINDOW_MANAGER_ERRORCODE_DEVICE_NOT_SUPPORTED，表示不支持功能。<br> 返回WINDOW_MANAGER_ERRORCODE_STATE_ABNORMAL，表示窗口状态异常。<br> 返回WINDOW_MANAGER_ERRORCODE_SYSTEM_ABNORMAL，表示窗口管理器服务异常。 | 75 76### OH_WindowManager_SetWindowStatusBarColor() 77 78``` 79int32_t OH_WindowManager_SetWindowStatusBarColor(int32_t windowId, int32_t color) 80``` 81 82**描述** 83 84设置指定窗口的状态栏内容颜色。 85 86**起始版本：** 15 87 88 89**参数：** 90 91| 参数项 | 描述 | 92| -- | -- | 93| int32_t windowId | 创建窗口时的窗口id。默认值为0。该参数为整数。 | 94| int32_t color | 要设置的颜色值，格式为ARGB。 | 95 96**返回：** 97 98| 类型 | 说明 | 99| -- | -- | 100| int32_t | 返回结果代码。<br> 返回OK，表示函数调用成功。<br> 返回WINDOW_MANAGER_ERRORCODE_INVALID_PARAM，表示参数错误。<br> 返回WINDOW_MANAGER_ERRORCODE_DEVICE_NOT_SUPPORTED，表示不支持功能。<br> 返回WINDOW_MANAGER_ERRORCODE_STATE_ABNORMAL，表示窗口状态异常。<br> 返回WINDOW_MANAGER_ERRORCODE_SYSTEM_ABNORMAL，表示窗口管理器服务异常。 | 101 102### OH_WindowManager_SetWindowNavigationBarEnabled() 103 104``` 105int32_t OH_WindowManager_SetWindowNavigationBarEnabled(int32_t windowId, bool enabled, bool enableAnimation) 106``` 107 108**描述** 109 110设置指定窗口是否显示导航栏。 111 112**起始版本：** 15 113 114 115**参数：** 116 117| 参数项 | 描述 | 118| -- | -- | 119| int32_t windowId | 创建窗口时的窗口id。默认值为0。该参数为整数。 | 120| bool enabled | 设置导航栏是否显示。true表示设置导航栏显示，false表示设置导航栏隐藏。 | 121| bool enableAnimation | 设置是否开启导航栏的显隐动画。true表示开启导航栏的显隐动画，false表示关闭导航栏的显隐动画。 | 122 123**返回：** 124 125| 类型 | 说明 | 126| -- | -- | 127| int32_t | 返回结果代码。<br> 返回OK，表示函数调用成功。<br> 返回WINDOW_MANAGER_ERRORCODE_INVALID_PARAM，表示参数错误。<br> 返回WINDOW_MANAGER_ERRORCODE_DEVICE_NOT_SUPPORTED，表示不支持功能。<br> 返回WINDOW_MANAGER_ERRORCODE_STATE_ABNORMAL，表示窗口状态异常。<br> 返回WINDOW_MANAGER_ERRORCODE_SYSTEM_ABNORMAL，表示窗口管理器服务异常。 | 128 129### OH_WindowManager_GetWindowAvoidArea() 130 131``` 132int32_t OH_WindowManager_GetWindowAvoidArea(int32_t windowId, WindowManager_AvoidAreaType type, WindowManager_AvoidArea* avoidArea) 133``` 134 135**描述** 136 137获取指定窗口的避让区域。 138 139**起始版本：** 15 140 141 142**参数：** 143 144| 参数项 | 描述 | 145| -- | -- | 146| int32_t windowId | 创建窗口时的窗口id。默认值为0。该参数为整数。 | 147| [WindowManager_AvoidAreaType](capi-oh-window-comm-h.md#windowmanager_avoidareatype) type | 避让区域的类型。 | 148| [WindowManager_AvoidArea](capi-windowmanager-avoidarea.md)* avoidArea | 返回指向指定窗口的避让区域的指针，作为出参使用。 | 149 150**返回：** 151 152| 类型 | 说明 | 153| -- | -- | 154| int32_t | 返回结果代码。<br> 返回OK，表示函数调用成功，返回指向对应窗口id的避让区域的指针。<br> 返回WINDOW_MANAGER_ERRORCODE_INVALID_PARAM，表示参数错误。<br> 返回WINDOW_MANAGER_ERRORCODE_STATE_ABNORMAL，表示窗口状态异常。<br> 返回WINDOW_MANAGER_ERRORCODE_SYSTEM_ABNORMAL，表示窗口管理器服务异常。 | 155 156### OH_WindowManager_IsWindowShown() 157 158``` 159int32_t OH_WindowManager_IsWindowShown(int32_t windowId, bool* isShow) 160``` 161 162**描述** 163 164判断指定窗口是否显示。 165 166**起始版本：** 15 167 168 169**参数：** 170 171| 参数项 | 描述 | 172| -- | -- | 173| int32_t windowId | 创建窗口时的窗口id。默认值为0。该参数为整数。 | 174| bool* isShow | 返回指定窗口是否显示的结果。true表示指定窗口显示，false表示指定窗口不显示，作为出参使用。 | 175 176**返回：** 177 178| 类型 | 说明 | 179| -- | -- | 180| int32_t | 返回结果代码。<br> 返回OK，表示函数调用成功。<br> 返回WINDOW_MANAGER_ERRORCODE_INVALID_PARAM，表示参数错误。<br> 返回WINDOW_MANAGER_ERRORCODE_STATE_ABNORMAL，表示窗口状态异常。 | 181 182### OH_WindowManager_ShowWindow() 183 184``` 185int32_t OH_WindowManager_ShowWindow(int32_t windowId) 186``` 187 188**描述** 189 190显示指定窗口。 191 192**起始版本：** 15 193 194 195**参数：** 196 197| 参数项 | 描述 | 198| -- | -- | 199| int32_t windowId | 创建窗口时的窗口id。默认值为0。该参数为整数。 | 200 201**返回：** 202 203| 类型 | 说明 | 204| -- | -- | 205| int32_t | 返回结果代码。<br> 返回OK，表示函数调用成功。<br> 返回WINDOW_MANAGER_ERRORCODE_INVALID_PARAM，表示参数错误。<br> 返回WINDOW_MANAGER_ERRORCODE_STATE_ABNORMAL，表示窗口状态异常。<br> 返回WINDOW_MANAGER_ERRORCODE_SYSTEM_ABNORMAL，表示窗口管理器服务异常。 | 206 207### OH_WindowManager_SetWindowTouchable() 208 209``` 210int32_t OH_WindowManager_SetWindowTouchable(int32_t windowId, bool isTouchable) 211``` 212 213**描述** 214 215设置指定窗口是否可触。 216 217**起始版本：** 15 218 219 220**参数：** 221 222| 参数项 | 描述 | 223| -- | -- | 224| int32_t windowId | 创建窗口时的窗口id。默认值为0。该参数为整数。 | 225| bool isTouchable | 窗口是否可触。true表示窗口可触，false表示窗口不可触。 | 226 227**返回：** 228 229| 类型 | 说明 | 230| -- | -- | 231| int32_t | 返回结果代码。<br> 返回OK，表示函数调用成功。<br> 返回WINDOW_MANAGER_ERRORCODE_INVALID_PARAM，表示参数错误。<br> 返回WINDOW_MANAGER_ERRORCODE_STATE_ABNORMAL，表示窗口状态异常。<br> 返回WINDOW_MANAGER_ERRORCODE_SYSTEM_ABNORMAL，表示窗口管理器服务异常。 | 232 233### OH_WindowManager_SetWindowFocusable() 234 235``` 236int32_t OH_WindowManager_SetWindowFocusable(int32_t windowId, bool isFocusable) 237``` 238 239**描述** 240 241设置指定窗口是否可获焦。 242 243**起始版本：** 15 244 245 246**参数：** 247 248| 参数项 | 描述 | 249| -- | -- | 250| int32_t windowId | 创建窗口时的窗口id。默认值为0。该参数为整数。 | 251| bool isFocusable | 窗口是否可获焦。true表示窗口可获焦，false表示窗口不可获焦。 | 252 253**返回：** 254 255| 类型 | 说明 | 256| -- | -- | 257| int32_t | 返回结果代码。<br> 返回OK，表示函数调用成功。<br> 返回WINDOW_MANAGER_ERRORCODE_INVALID_PARAM，表示参数错误。<br> 返回WINDOW_MANAGER_ERRORCODE_STATE_ABNORMAL，表示窗口状态异常。<br> 返回WINDOW_MANAGER_ERRORCODE_SYSTEM_ABNORMAL，表示窗口管理器服务异常。 | 258 259### OH_WindowManager_SetWindowBackgroundColor() 260 261``` 262int32_t OH_WindowManager_SetWindowBackgroundColor(int32_t windowId, const char* color) 263``` 264 265**描述** 266 267设置指定窗口背景颜色。 268 269**起始版本：** 15 270 271 272**参数：** 273 274| 参数项 | 描述 | 275| -- | -- | 276| int32_t windowId | 创建窗口时的窗口id。默认值为0。该参数为整数。 | 277| const char* color | 设置窗口的背景色。该参数为字符串类型，格式为十六进制RGB或ARGB颜色。 | 278 279**返回：** 280 281| 类型 | 说明 | 282| -- | -- | 283| int32_t | 返回结果代码。<br> 返回OK，表示函数调用成功。<br> 返回WINDOW_MANAGER_ERRORCODE_INVALID_PARAM，表示参数错误。<br> 返回WINDOW_MANAGER_ERRORCODE_STATE_ABNORMAL，表示窗口状态异常。 | 284 285### OH_WindowManager_SetWindowBrightness() 286 287``` 288int32_t OH_WindowManager_SetWindowBrightness(int32_t windowId, float brightness) 289``` 290 291**描述** 292 293设置指定窗口的屏幕亮度。 294 295**起始版本：** 15 296 297 298**参数：** 299 300| 参数项 | 描述 | 301| -- | -- | 302| int32_t windowId | 创建窗口时的窗口id。默认值为0。该参数为整数。 | 303| float brightness | 指定的屏幕亮度值。该参数为浮点数，取值范围为[0.0, 1.0]或-1.0。1.0表示最亮，-1.0表示恢复成设置窗口亮度前的系统控制中心亮度。| 304 305**返回：** 306 307| 类型 | 说明 | 308| -- | -- | 309| int32_t | 返回结果代码。<br> 返回OK，表示函数调用成功。<br> 返回WINDOW_MANAGER_ERRORCODE_INVALID_PARAM，表示参数错误。<br> 返回WINDOW_MANAGER_ERRORCODE_STATE_ABNORMAL，表示窗口状态异常。<br> 返回WINDOW_MANAGER_ERRORCODE_SYSTEM_ABNORMAL，表示窗口管理器服务异常。 | 310 311### OH_WindowManager_SetWindowKeepScreenOn() 312 313``` 314int32_t OH_WindowManager_SetWindowKeepScreenOn(int32_t windowId, bool isKeepScreenOn) 315``` 316 317**描述** 318 319设置指定窗口是否开启屏幕常亮。 320 321**起始版本：** 15 322 323 324**参数：** 325 326| 参数项 | 描述 | 327| -- | -- | 328| int32_t windowId | 创建窗口时的窗口id。默认值为0。该参数为整数。 | 329| bool isKeepScreenOn | 指定窗口是否开启屏幕常亮。true表示开启屏幕常亮，false表示关闭屏幕常亮。 | 330 331**返回：** 332 333| 类型 | 说明 | 334| -- | -- | 335| int32_t | 返回结果代码。<br> 返回OK，表示函数调用成功。<br> 返回WINDOW_MANAGER_ERRORCODE_INVALID_PARAM，表示参数错误。<br> 返回WINDOW_MANAGER_ERRORCODE_STATE_ABNORMAL，表示窗口状态异常。<br> 返回WINDOW_MANAGER_ERRORCODE_SYSTEM_ABNORMAL，表示窗口管理器服务异常。 | 336 337### OH_WindowManager_SetWindowPrivacyMode() 338 339``` 340int32_t OH_WindowManager_SetWindowPrivacyMode(int32_t windowId, bool isPrivacy) 341``` 342 343**描述** 344 345设置指定窗口是否开启隐私模式。 346 347**需要权限：** ohos.permission.PRIVACY_WINDOW 348 349**起始版本：** 15 350 351 352**参数：** 353 354| 参数项 | 描述 | 355| -- | -- | 356| int32_t windowId | 创建窗口时的窗口id。默认值为0。该参数为整数。 | 357| bool isPrivacy | 指定窗口是否开启隐私模式。true表示开启隐私模式，false表示关闭隐私模式。 | 358 359**返回：** 360 361| 类型 | 说明 | 362| -- | -- | 363| int32_t | 返回结果代码。<br> 返回OK，表示函数调用成功。<br> 返回WINDOW_MANAGER_ERRORCODE_INVALID_PARAM，表示参数错误。<br> 返回WINDOW_MANAGER_ERRORCODE_STATE_ABNORMAL，表示窗口状态异常。<br> 返回WINDOW_MANAGER_ERRORCODE_SYSTEM_ABNORMAL，表示窗口管理器服务异常。<br> 返回WINDOW_MANAGER_ERRORCODE_NO_PERMISSION，权限校验错误。 | 364 365### OH_WindowManager_GetWindowProperties() 366 367``` 368int32_t OH_WindowManager_GetWindowProperties(int32_t windowId, WindowManager_WindowProperties* windowProperties) 369``` 370 371**描述** 372 373获取指定窗口属性。 374 375**起始版本：** 15 376 377 378**参数：** 379 380| 参数项 | 描述 | 381| -- | -- | 382| int32_t windowId | 创建窗口时的窗口id。默认值为0。该参数为整数。 | 383| [WindowManager_WindowProperties](capi-windowmanager-windowproperties.md)* windowProperties | 返回指向指定窗口的属性的指针，作为出参使用。 | 384 385**返回：** 386 387| 类型 | 说明 | 388| -- | -- | 389| int32_t | 返回结果代码。<br> 返回OK，表示函数调用成功，在windowProperties中返回窗口属性的指针。<br> 返回WINDOW_MANAGER_ERRORCODE_INVALID_PARAM，表示参数错误。<br> 返回WINDOW_MANAGER_ERRORCODE_STATE_ABNORMAL，表示窗口状态异常。| 390 391### OH_WindowManager_Snapshot() 392 393``` 394int32_t OH_WindowManager_Snapshot(int32_t windowId, OH_PixelmapNative* pixelMap) 395``` 396 397**描述** 398 399获取指定窗口截图。 400 401**起始版本：** 15 402 403 404**参数：** 405 406| 参数项 | 描述 | 407| -- | -- | 408| int32_t windowId | 创建窗口时的窗口id。默认值为0。该参数为整数。<br>窗口id非法或者窗口已经销毁，不能获取指定窗口截图，需要传入有效的窗口id才能成功获取指定窗口截图。<br>请通过窗口对象调用[getWindowProperties()](arkts-apis-window-Window.md#getwindowproperties9)接口（ArkTS接口）获取有效的窗口id。 | 409| [OH_PixelmapNative](capi-struct.md)* pixelMap | 返回指向指定窗口的截图的指针，作为出参使用。 | 410 411**返回：** 412 413| 类型 | 说明 | 414| -- | -- | 415| int32_t | 返回结果代码。<br> 返回OK，表示函数调用成功，在返回pixelMap中的像素图的指针。<br> 返回WINDOW_MANAGER_ERRORCODE_INVALID_PARAM，表示参数错误。<br> 返回WINDOW_MANAGER_ERRORCODE_STATE_ABNORMAL，表示窗口状态异常。 | 416 417### OH_WindowManager_GetAllWindowLayoutInfoList() 418 419``` 420int32_t OH_WindowManager_GetAllWindowLayoutInfoList(int64_t displayId,WindowManager_Rect** windowLayoutInfoList, size_t* windowLayoutInfoSize) 421``` 422 423**描述** 424 425获取指定屏幕上可见的窗口布局信息数组，按当前窗口层级排列，层级最高的对应数组下标为0。 426 427**起始版本：** 17 428 429 430**参数：** 431 432| 参数项 | 描述 | 433| -- | -- | 434| int64_t displayId | 指定屏幕的id。请通过窗口对象调用[getWindowProperties()](arkts-apis-window-Window.md#getwindowproperties9)接口（ArkTS接口）获取有效的屏幕id。 | 435| [WindowManager_Rect](capi-windowmanager-rect.md)** windowLayoutInfoList | 指定屏幕上可见的窗口布局信息数组的数组指针，作为出参使用。 | 436| size_t* windowLayoutInfoSize | 指定屏幕上可见的窗口布局信息数组长度的指针，作为出参使用。 | 437 438**返回：** 439 440| 类型 | 说明 | 441| -- | -- | 442| int32_t | 返回结果代码。<br> 返回OK，表示函数调用成功，返回指定屏幕上可见的窗口布局信息数组的数组指针和数组长度的指针。<br> 返回WINDOW_MANAGER_ERRORCODE_INVALID_PARAM，表示参数错误。<br> 返回WINDOW_MANAGER_ERRORCODE_DEVICE_NOT_SUPPORTED，表示不支持功能。<br> 返回WINDOW_MANAGER_ERRORCODE_SYSTEM_ABNORMAL，表示窗口管理器服务异常。 | 443 444### OH_WindowManager_ReleaseAllWindowLayoutInfoList() 445 446``` 447void OH_WindowManager_ReleaseAllWindowLayoutInfoList(WindowManager_Rect* windowLayoutInfoList) 448``` 449 450**描述** 451 452释放窗口布局信息数组占用的内存。 453 454**起始版本：** 17 455 456 457**参数：** 458 459| 参数项 | 描述 | 460| -- | -- | 461| [WindowManager_Rect](capi-windowmanager-rect.md)* windowLayoutInfoList | 指定屏幕上可见的窗口布局信息数组的数组指针，可通过[OH_WindowManager_GetAllWindowLayoutInfoList](capi-oh-window-h.md#oh_windowmanager_getallwindowlayoutinfolist)接口获取。 | 462### OH_WindowManager_InjectTouchEvent() 463 464``` 465int32_t OH_WindowManager_InjectTouchEvent(int32_t windowId, Input_TouchEvent* touchEvent, int32_t windowX, int32_t windowY) 466``` 467 468**描述** 469 470将多模触摸事件注入给目标窗口，仅支持注入同进程窗口，且该注入不会触发窗口焦点和层级变化，不会触发窗口拖拽，事件会直接发送给ArkUI。该接口需要在指定窗口加载UI之后调用。 471 472**起始版本：** 20 473 474**参数：** 475 476| 参数项 | 描述 | 477| -- | -- | 478| int32_t windowId | 创建窗口时的窗口id。默认值为0。该参数为整数。 | 479| [Input_TouchEvent](../apis-input-kit/capi-input-input-touchevent.md)* touchEvent | 多模触摸事件，具体可见[Input_TouchEvent](../apis-input-kit/capi-input-input-touchevent.md)，事件定义在oh_input_manager.h中。该参数包含的部分字段有参数限制，其中，action应为大于等于0且小于等于3的整数；id、displayX、displayY和actionTime应为不小于0的整数。以上参数不符合限制条件会返回WINDOW_MANAGER_ERRORCODE_STATE_ABNORMAL，表示：窗口管理器服务异常。 | 480| int32_t windowX | 注入事件相对于注入窗口的落点横坐标。该参数为整数。 | 481| int32_t windowY | 注入事件相对于注入窗口的落点纵坐标。该参数为整数。 | 482 483**返回：** 484 485| 类型 | 说明 | 486| -- | -- | 487| int32_t | 返回结果代码。<br>返回OK，表示函数调用成功。<br>返回WINDOW_MANAGER_ERRORCODE_STATE_ABNORMAL，表示窗口状态异常。<br>返回WINDOW_MANAGER_ERRORCODE_SYSTEM_ABNORMAL，表示窗口管理器服务异常。 |