NDK接口针对UI组件的事件,提供了监听函数的方式。首先,可使用addNodeEventReceiver函数添加组件事件的监听器,该监听器会监听该组件上发生的所有事件,例如:点击事件、焦点事件。然后,可使用registerNodeEvent函数声明组件的哪些事件需要监听,NDK接口支持的事件范围通过ArkUI_NodeEventType枚举值定义。
说明
事件注册需要声明addNodeEventReceiver监听器注册和registerNodeEvent事件类型,监听器只能监听已声明的事件。
需要关注事件的反注册逻辑,如在组件销毁前调用removeNodeEventReceiver移除事件监听器,unregisterNodeEvent通知ArkUI框架已监听的事件不再需要监听。
addNodeEventReceiver可以添加多个函数指针,每个函数指针都会在对应事件触发时触发,对应的removeNodeEventReceiver需要传递对应的函数指针用于移除监听。
registerNodeEventReceiver是全局监听函数,不同于addNodeEventReceiver,registerEventReceiver能够监听所有Native组件的事件触发,但只能传递一个函数指针,多次调用使用最后一次的函数指针进行回调,释放时使用ungisterNodeEventReceiver进行释放。
以下示例基于接入ArkTS页面章节,补充相关事件监听。
-
在ArkUINode基类对象中实现通用事件注册逻辑。
// ArkUINode.h // 提供通用属性和事件的封装。 #ifndef MYAPPLICATION_ARKUINODE_H #define MYAPPLICATION_ARKUINODE_H #include "ArkUIBaseNode.h" #include "NativeModule.h" #include <arkui/native_node.h> #include <arkui/native_type.h> namespace NativeModule { class ArkUINode : public ArkUIBaseNode { public: explicit ArkUINode(ArkUI_NodeHandle handle) : ArkUIBaseNode(handle) { nativeModule_ = NativeModuleInstance::GetInstance()->GetNativeNodeAPI(); // 事件触发时需要通过函数获取对应的事件对象,这边通过设置节点自定义数据将封装类指针保持在组件上,方便后续事件分发。 nativeModule_->setUserData(handle_, this); // 注册节点监听事件接受器。 nativeModule_->addNodeEventReceiver(handle_, ArkUINode::NodeEventReceiver); } ~ArkUINode() override { if (onClick_) { nativeModule_->unregisterNodeEvent(handle_, NODE_ON_CLICK); } if (onTouch_) { nativeModule_->unregisterNodeEvent(handle_, NODE_TOUCH_EVENT); }