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); } if (onDisappear) { nativeModule_->unregisterNodeEvent(handle_, NODE_EVENT_ON_DISAPPEAR); } if (onAppear) { nativeModule_->unregisterNodeEvent(handle_, NODE_EVENT_ON_APPEAR); } nativeModule_->removeNodeEventReceiver(handle_, ArkUINode::NodeEventReceiver); } void SetWidth(float width) { assert(handle_); ArkUI_NumberValue value[] = {{.f32 = width}}; ArkUI_AttributeItem item = {value, 1}; nativeModule_->setAttribute(handle_, NODE_WIDTH, &item); } void SetPercentWidth(float percent) { assert(handle_); ArkUI_NumberValue value[] = {{.f32 = percent}}; ArkUI_AttributeItem item = {value, 1}; nativeModule_->setAttribute(handle_, NODE_WIDTH_PERCENT, &item); } void SetHeight(float height) { assert(handle_); ArkUI_NumberValue value[] = {{.f32 = height}}; ArkUI_AttributeItem item = {value, 1}; nativeModule_->setAttribute(handle_, NODE_HEIGHT, &item); } void SetPercentHeight(float percent) { assert(handle_); ArkUI_NumberValue value[] = {{.f32 = percent}}; ArkUI_AttributeItem item = {value, 1}; nativeModule_->setAttribute(handle_, NODE_HEIGHT_PERCENT, &item); } void SetBackgroundColor(uint32_t color) { assert(handle_); ArkUI_NumberValue value[] = {{.u32 = color}}; ArkUI_AttributeItem item = {value, 1}; nativeModule_->setAttribute(handle_, NODE_BACKGROUND_COLOR, &item); } // 处理通用事件。 void RegisterOnClick(const std::function<void()> &onClick) { assert(handle_); onClick_ = onClick; // 注册点击事件。 nativeModule_->registerNodeEvent(handle_, NODE_ON_CLICK, 0, nullptr); } void RegisterOnTouch(const std::function<void(int32_t type, float x, float y)> &onTouch) { assert(handle_); onTouch_ = onTouch; // 注册触碰事件。 nativeModule_->registerNodeEvent(handle_, NODE_TOUCH_EVENT, 0, nullptr); } void RegisterOnDisappear(const std::function<void()> &onDisappear) { assert(handle_); onDisappear_ = onDisappear; // 注册卸载事件。 nativeModule_->registerNodeEvent(handle_, NODE_EVENT_ON_DISAPPEAR, 0, nullptr); } void RegisterOnAppear(const std::function<void()> &onAppear) { assert(handle_); onAppear_ = onAppear; // 注册挂载事件。 nativeModule_->registerNodeEvent(handle_, NODE_EVENT_ON_APPEAR, 0, nullptr); } protected: // 事件监听器函数指针。 static void NodeEventReceiver(ArkUI_NodeEvent *event) { // 获取事件发生的UI组件对象。 auto nodeHandle = OH_ArkUI_NodeEvent_GetNodeHandle(event); // 获取保持在UI组件对象中的自定义数据,返回封装类指针。 auto *node = reinterpret_cast<ArkUINode *>( NativeModuleInstance::GetInstance()->GetNativeNodeAPI()->getUserData(nodeHandle)); // 基于封装类实例对象处理事件。 node->ProcessNodeEvent(event); } void ProcessNodeEvent(ArkUI_NodeEvent *event) { auto eventType = OH_ArkUI_NodeEvent_GetEventType(event); switch (eventType) { case NODE_ON_CLICK: { if (onClick_) { onClick_(); } break; } case NODE_TOUCH_EVENT: { if (onTouch_) { auto *uiInputEvent = OH_ArkUI_NodeEvent_GetInputEvent(event); float x = OH_ArkUI_PointerEvent_GetX(uiInputEvent); float y = OH_ArkUI_PointerEvent_GetY(uiInputEvent); auto type = OH_ArkUI_UIInputEvent_GetAction(uiInputEvent); onTouch_(type, x, y); } } case NODE_EVENT_ON_DISAPPEAR: { if (onDisappear_) { onDisappear_(); } break; } case NODE_EVENT_ON_APPEAR: { if (onAppear_) { onAppear_(); } break; } default: { // 组件特有事件交给子类处理 OnNodeEvent(event); } } } virtual void OnNodeEvent(ArkUI_NodeEvent *event) {} void OnAddChild(const std::shared_ptr<ArkUIBaseNode> &child) override { nativeModule_->addChild(handle_, child->GetHandle()); } void OnRemoveChild(const std::shared_ptr<ArkUIBaseNode> &child) override { nativeModule_->removeChild(handle_, child->GetHandle()); } void OnInsertChild(const std::shared_ptr<ArkUIBaseNode> &child, int32_t index) override { nativeModule_->insertChildAt(handle_, child->GetHandle(), index); } private: std::function<void()> onClick_; std::function<void()> onDisappear_; std::function<void()> onAppear_; std::function<void(int32_t type, float x, float y)> onTouch_; }; } // namespace NativeModule #endif // MYAPPLICATION_ARKUINODE_H
-
在ArkUIListNode对象中实现列表事件注册逻辑。
// ArkUIListNode.h // 列表封装类对象 #ifndef MYAPPLICATION_ARKUILISTNODE_H #define MYAPPLICATION_ARKUILISTNODE_H #include "ArkUINode.h" #include <hilog/log.h> namespace NativeModule { class ArkUIListNode : public ArkUINode { public: ArkUIListNode() : ArkUINode((NativeModuleInstance::GetInstance()->GetNativeNodeAPI())->createNode(ARKUI_NODE_LIST)) {} ~ArkUIListNode() override { nativeModule_->unregisterNodeEvent(handle_, NODE_LIST_ON_SCROLL_INDEX); } void SetScrollBarState(bool isShow) { assert(handle_); ArkUI_ScrollBarDisplayMode displayMode = isShow ? ARKUI_SCROLL_BAR_DISPLAY_MODE_ON : ARKUI_SCROLL_BAR_DISPLAY_MODE_OFF; ArkUI_NumberValue value[] = {{.i32 = displayMode}}; ArkUI_AttributeItem item = {value, 1}; nativeModule_->setAttribute(handle_, NODE_SCROLL_BAR_DISPLAY_MODE, &item); } // 注册列表相关事件。 void RegisterOnScrollIndex(const std::function<void(int32_t index)> &onScrollIndex) { assert(handle_); onScrollIndex_ = onScrollIndex; nativeModule_->registerNodeEvent(handle_, NODE_LIST_ON_SCROLL_INDEX, 0, nullptr); } protected: // 处理List相关事件。 void OnNodeEvent(ArkUI_NodeEvent *event) override { auto eventType = OH_ArkUI_NodeEvent_GetEventType(event); switch (eventType) { case NODE_LIST_ON_SCROLL_INDEX: { auto index = OH_ArkUI_NodeEvent_GetNodeComponentEvent(event)->data[0]; if (onScrollIndex_) { onScrollIndex_(index.i32); } } default: { } } } private: std::function<void(int32_t index)> onScrollIndex_; }; } // namespace NativeModule #endif // MYAPPLICATION_ARKUILISTNODE_H
-
添加相关事件。
// TextListExample.h // 文本列表示例。 #ifndef MYAPPLICATION_NORMALTEXTLISTEXAMPLE_H #define MYAPPLICATION_NORMALTEXTLISTEXAMPLE_H #include "ArkUIBaseNode.h" #include "ArkUIListItemNode.h" #include "ArkUIListNode.h" #include "ArkUITextNode.h" #include <hilog/log.h> namespace NativeModule { std::shared_ptr<ArkUIBaseNode> CreateTextListExample() { // 创建组件并挂载 // 1:创建List组件。 auto list = std::make_shared<ArkUIListNode>(); list->SetPercentWidth(1); list->SetPercentHeight(1); // 2:创建ListItem子组件并挂载到List上。 for (int32_t i = 0; i < 30; ++i) { auto listItem = std::make_shared<ArkUIListItemNode>(); auto textNode = std::make_shared<ArkUITextNode>(); textNode->SetTextContent(std::to_string(i)); textNode->SetFontSize(16); textNode->SetPercentWidth(1); textNode->SetHeight(100); textNode->SetBackgroundColor(0xFFfffacd); textNode->SetTextAlign(ARKUI_TEXT_ALIGNMENT_CENTER); listItem->AddChild(textNode); // 列表项注册点击事件。 listItem->RegisterOnClick([i]() { OH_LOG_INFO(LOG_APP, "on %{public}d list item click", i); }); list->AddChild(listItem); } // 3:注册List相关监听事件. list->RegisterOnScrollIndex([](int32_t index) { OH_LOG_INFO(LOG_APP, "on list scroll index: %{public}d", index); }); // 4: 注册挂载事件。 list->RegisterOnAppear([]() { OH_LOG_INFO(LOG_APP, "on list mount to tree"); }); // 4: 注册卸载事件。 list->RegisterOnDisappear([]() { OH_LOG_INFO(LOG_APP, "on list unmount from tree"); }); return list; } } // namespace NativeModule #endif // MYAPPLICATION_NORMALTEXTLISTEXAMPLE_H
最后
有很多小伙伴不知道学习哪些鸿蒙开发技术?不知道需要重点掌握哪些鸿蒙应用开发知识点?而且学习时频繁踩坑,最终浪费大量时间。所以有一份实用的鸿蒙(HarmonyOS NEXT)资料用来跟着学习是非常有必要的。
这份鸿蒙(HarmonyOS NEXT)资料包含了鸿蒙开发必掌握的核心知识要点,内容包含了(ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、音频、视频、WebGL、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、OpenHarmony南向开发、鸿蒙项目实战等等)鸿蒙(HarmonyOS NEXT)技术知识点。
希望这一份鸿蒙学习资料能够给大家带来帮助,有需要的小伙伴自行领取,限时开源,先到先得~无套路领取!!
获取这份完整版高清学习路线,请点击→纯血版全套鸿蒙HarmonyOS NEXT学习资料
鸿蒙(HarmonyOS NEXT)最新学习路线
-
HarmonOS基础技能
- HarmonOS就业必备技能
- HarmonOS多媒体技术
- 鸿蒙NaPi组件进阶
- HarmonOS高级技能
- 初识HarmonOS内核
- 实战就业级设备开发
有了路线图,怎么能没有学习资料呢,小编也准备了一份联合鸿蒙官方发布笔记整理收纳的一套系统性的鸿蒙(OpenHarmony )学习手册(共计1236页)与鸿蒙(OpenHarmony )开发入门教学视频,内容包含:ArkTS、ArkUI、Web开发、应用模型、资源分类…等知识点。
获取以上完整版高清学习路线,请点击→纯血版全套鸿蒙HarmonyOS NEXT学习资料
《鸿蒙 (OpenHarmony)开发入门教学视频》
《鸿蒙生态应用开发V2.0白皮书》
《鸿蒙 (OpenHarmony)开发基础到实战手册》
OpenHarmony北向、南向开发环境搭建
《鸿蒙开发基础》
- ArkTS语言
- 安装DevEco Studio
- 运用你的第一个ArkTS应用
- ArkUI声明式UI开发
- .……
《鸿蒙开发进阶》
- Stage模型入门
- 网络管理
- 数据管理
- 电话服务
- 分布式应用开发
- 通知与窗口管理
- 多媒体技术
- 安全技能
- 任务管理
- WebGL
- 国际化开发
- 应用测试
- DFX面向未来设计
- 鸿蒙系统移植和裁剪定制
- ……
《鸿蒙进阶实战》
- ArkTS实践
- UIAbility应用
- 网络案例
- ……
获取以上完整鸿蒙HarmonyOS学习资料,请点击→纯血版全套鸿蒙HarmonyOS NEXT学习资料
总结
总的来说,华为鸿蒙不再兼容安卓,对中年程序员来说是一个挑战,也是一个机会。只有积极应对变化,不断学习和提升自己,他们才能在这个变革的时代中立于不败之地。