设置事件回调

NOTE

本模块首批接口从API version 12开始支持,后续版本的新增接口,采用上角标单独标记接口的起始版本。

UICommonEvent

用于设置基础事件回调。方法入参为undefined的时候,重置对应的事件回调。

setOnClick

setOnClick(callback: Callback<ClickEvent> | undefined): void

设置点击事件的回调。

元服务API: 从API version 12开始,该接口支持在元服务中使用。

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

参数:

参数名 类型 必填 说明
callback Callback<ClickEvent> | undefined 点击事件的回调函数。

setOnTouch

setOnTouch(callback: Callback<TouchEvent> | undefined): void

设置触摸事件的回调。

元服务API: 从API version 12开始,该接口支持在元服务中使用。

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

参数:

参数名 类型 必填 说明
callback Callback<TouchEvent> | undefined 触摸事件的回调函数。

setOnAppear

setOnAppear(callback: Callback<void> | undefined): void

设置onAppear事件的回调。

元服务API: 从API version 12开始,该接口支持在元服务中使用。

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

参数:

参数名 类型 必填 说明
callback Callback<void> | undefined onAppear事件的回调函数。

setOnDisappear

setOnDisappear(callback: Callback<void> | undefined): void

设置onDisappear事件的回调。

元服务API: 从API version 12开始,该接口支持在元服务中使用。

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

参数:

参数名 类型 必填 说明
callback Callback<void> | undefined onDisappear事件的回调。

setOnKeyEvent

setOnKeyEvent(callback: Callback<KeyEvent> | undefined): void

设置按键事件的回调。

元服务API: 从API version 12开始,该接口支持在元服务中使用。

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

参数:

参数名 类型 必填 说明
callback Callback<KeyEvent> | undefined 按键事件的回调函数。

setOnFocus

setOnFocus(callback: Callback<void> | undefined): void

设置onFocus事件的回调。

元服务API: 从API version 12开始,该接口支持在元服务中使用。

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

参数:

参数名 类型 必填 说明
callback Callback<void> | undefined onFocus事件的回调。

setOnBlur

setOnBlur(callback: Callback<void> | undefined): void

设置onBlur事件的回调。

元服务API: 从API version 12开始,该接口支持在元服务中使用。

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

参数:

参数名 类型 必填 说明
callback Callback<void> | undefined onBlur事件的回调。

setOnHover

setOnHover(callback: HoverCallback | undefined): void

设置onHover事件的回调。

元服务API: 从API version 12开始,该接口支持在元服务中使用。

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

参数:

参数名 类型 必填 说明
callback HoverCallback | undefined onHover事件的回调函数。

setOnMouse

setOnMouse(callback: Callback<MouseEvent> | undefined): void

设置onMouse事件的回调。

元服务API: 从API version 12开始,该接口支持在元服务中使用。

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

参数:

参数名 类型 必填 说明
callback Callback<MouseEvent> | undefined onMouse事件的回调函数。

setOnSizeChange

setOnSizeChange(callback: SizeChangeCallback | undefined): void

设置onSizeChange事件的回调。

元服务API: 从API version 12开始,该接口支持在元服务中使用。

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

参数:

参数名 类型 必填 说明
callback SizeChangeCallback | undefined onSizeChange事件的回调函数。

setOnVisibleAreaApproximateChange

setOnVisibleAreaApproximateChange(options: VisibleAreaEventOptions, event: VisibleAreaChangeCallback | undefined): void

设置限制回调间隔的onVisibleAreaChange事件的回调。

元服务API: 从API version 12开始,该接口支持在元服务中使用。

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

参数:

参数名 类型 必填 说明
options VisibleAreaEventOptions 可见区域变化相关的参数。
event VisibleAreaChangeCallback | undefined onVisibleAreaChange事件的回调函数。当组件可见面积与自身面积的比值接近options中设置的阈值时触发该回调。
NOTE

非实时回调,实际回调与预期间隔可能存在差别。

两次可见区域回调的时间间隔不小于预期更新间隔。当开发者设置的预期间隔过小时,由系统负载决定实际回调间隔时间。

当前接口的可见区域回调阈值默认包含0。例如,开发者设置回调阈值为[0.5],实际生效的阈值为[0.0, 0.5]。

Search
Enter a keyword.