本模块首批接口从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
参数：
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中设置的阈值时触发该回调。 |
说明
非实时回调，实际回调与预期间隔可能存在差别。
两次可见区域回调的时间间隔不小于预期更新间隔。当开发者设置的预期间隔过小时，由系统负载决定实际回调间隔时间。
当前接口的可见区域回调阈值默认包含0。例如，开发者设置回调阈值为[0.5]，实际生效的阈值为[0.0, 0.5]。
搜索
请输入您想要搜索的关键词