harmony 鸿蒙设置事件回调

2025-06-12
浏览 (3)

设置事件回调

说明：

本模块首批接口从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中设置的阈值时触发该回调。