harmony 鸿蒙@ohos.arkui.inspector (布局回调)

  • 2023-10-30
  • 浏览 (564)

@ohos.arkui.inspector (布局回调)

提供注册组件布局和绘制完成回调通知的能力。

说明:

从API Version 10开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。

从API version 10开始,可以通过使用UIContext中的getUIInspector方法获取当前UI上下文关联的UIInspector对象。

导入模块

import inspector from '@ohos.arkui.inspector'

inspector.createComponentObserver

createComponentObserver(id: string): ComponentObserver

绑定指定组件,返回对应的监听句柄。

系统能力: SystemCapability.ArkUI.ArkUI.Full

参数:

参数名 类型 必填 说明
id string 指定组件id。

返回值:

类型 说明
ComponentObserver 组件回调事件监听句柄,用于注册和取消注册监听回调。

示例:

let listener:inspector.ComponentObserver = inspector.createComponentObserver('COMPONENT_ID'); //监听id为COMPONENT_ID的组件回调事件

ComponentObserver

组件布局绘制完成回调的句柄,包含了申请句柄时的首次查询结果。

on

on(type: ‘layout’, callback: () => void): void

通过句柄向对应的查询条件注册回调,当组件布局完成时会触发该回调。

系统能力: SystemCapability.ArkUI.ArkUI.Full

参数:

参数名 类型 必填 说明
type string 必须填写字符串’layout’或’draw’。
layout: 组件布局完成。
draw: 组件绘制完成。
callback void 监听layout或draw的回调。

off

off(type: ‘layout’, callback?: () => void): void

通过句柄向对应的查询条件取消注册回调,当组件布局完成时不再触发指定的回调。

系统能力: SystemCapability.ArkUI.ArkUI.Full

参数:

参数名 类型 必填 说明
type string 必须填写字符串’layout’或’draw’。
layout: 组件布局完成。
draw: 组件绘制完成。
callback void 需要取消注册的回调,如果参数缺省则取消注册该句柄下所有的回调。

on

on(type: ‘draw’, callback: () => void): void

通过句柄向对应的查询条件注册回调,当组件绘制完成时会触发该回调。

系统能力: SystemCapability.ArkUI.ArkUI.Full

参数:

参数名 类型 必填 说明
type string 必须填写字符串’layout’或’draw’。
layout: 组件布局完成。
draw: 组件绘制完成。
callback void 监听layout或draw的回调。

off

off(type: ‘draw’, callback?: () => void): void

通过句柄向对应的查询条件取消注册回调,当组件绘制完成时不再触发指定的回调。

系统能力: SystemCapability.ArkUI.ArkUI.Full

参数:

参数名 类型 必填 说明
type string 必须填写字符串’layout’或’draw’。
layout: 组件布局完成。
draw: 组件绘制完成。
callback void 需要取消注册的回调,如果参数缺省则取消注册该句柄下所有的回调。

示例:

  import inspector from '@ohos.arkui.inspector'

  @Entry
  @Component
  struct ImageExample {
    build() {
      Column() {
        Flex({ direction: FlexDirection.Column, alignItems: ItemAlign.Start }) {
          Row({ space: 5 }) {
            Image($r('app.media.app_icon'))
              .width(110)
              .height(110)
              .border({ width: 1 })
              .id('IMAGE_ID')
          }
        }
      }.height(320).width(360).padding({ right: 10, top: 10 })
    }

    listener:inspector.ComponentObserver = inspector.createComponentObserver('IMAGE_ID')

    aboutToAppear() {
      let onLayoutComplete:()=>void=():void=>{
          // do something here
      }
      let onDrawComplete:()=>void=():void=>{
          // do something here
      }
      let FuncLayout = onLayoutComplete // bind current js instance
      let FuncDraw = onDrawComplete // bind current js instance

      this.listener.on('layout', FuncLayout)
      this.listener.on('draw', FuncDraw)
    }
  }

你可能感兴趣的鸿蒙文章

harmony 鸿蒙接口

harmony 鸿蒙系统公共事件定义(待停用)

harmony 鸿蒙系统公共事件定义

harmony 鸿蒙开发说明

harmony 鸿蒙企业设备管理概述(仅对系统应用开放)

harmony 鸿蒙BundleStatusCallback

harmony 鸿蒙@ohos.bundle.innerBundleManager (innerBundleManager模块)

harmony 鸿蒙@ohos.distributedBundle (分布式包管理)

harmony 鸿蒙@ohos.bundle (Bundle模块)

harmony 鸿蒙@ohos.enterprise.EnterpriseAdminExtensionAbility (企业设备管理扩展能力)

0  赞