ArkUI使用DrawableDescriptor指南文档示例
介绍
本示例通过使用drawable_descriptor.h中的接口,帮助开发者更好的理解并合理使用ArkUI提供的组件以及组件属性。该工程创建Image组件,入参类型为DrawableDescriptor,并可以设置duration、iteration属性。
效果预览
| 首页 | 设置属性 |
|---|---|
![]() |
![]() |
使用说明
-
工程启动后,通过文本输入,设置属性值。
-
在"设置duration"和"设置iteration"文本输入框中,分别输入属性值,其中duration为动图播放的播放时长,iteration为动图播放的次数。
-
分别点击"设置",查看已设置属性值的显示效果。
-
工程启动后,会自动加载图片并触发对OH_ArkUI_DrawableDescriptor_GetStaticPixelMap、OH_ArkUI_DrawableDescriptor_GetAnimatedPixelMapArray、OH_ArkUI_DrawableDescriptor_GetAnimatedPixelMapArraySize这几个接口的调用,若接口成功调用可以在DevEco Studio开发环境中的日志界面看到如下相关日志信息:
"GetStaticPixelMap success"
"GetAnimatedPixelMapArray success"
"GetAnimatedPixelMapArraySize success"
- 退出工程后,会自动调用OH_ArkUI_DrawableDescriptor_Dispose接口,若接口成功调用可以在DevEco Studio开发环境中的日志界面看到如下相关日志信息:
"Dispose success"
工程目录
entry/src/main/cpp
|---CMakeLists.txt // 编译脚本
|---napi_init.cpp // 实现资源创建、属性设置相关功能
|---drawable_manager.cpp // 管理DrawableDescriptor节点
|---types
|---Index.d.ts // 注册napi函数到ets层,供上层调用
entry/src/main/ets/
|---entryability
|---pages
| |---Index.ets // 应用主页面
entry/src/ohosTest/
|---ets
| |---index.test.ets // 示例代码测试代码
具体实现
- 在Index.ets文件中,通过文本输入框和"设置"按钮设置Image组件属性值。
- 在Index.d.ts文件中,注册napi函数到ets层。
- 在napi_init.cpp文件中,实现Index.d.ts中对外的接口。
- 在drawable_manager.cpp文件中,实现对DrawableDescriptor节点的保存、获取、删除功能。
相关权限
不涉及。
依赖
不涉及。
约束与限制
-
本示例仅支持标准系统上运行, 支持设备:华为手机。
-
HarmonyOS系统:HarmonyOS 5.0.5 Release及以上。
-
DevEco Studio版本:6.0.0 Release及以上。
-
HarmonyOS SDK版本:HarmonyOS 6.0.0 Release SDK及以上。
下载
如需单独下载本工程,执行如下命令:
git init
git config core.sparsecheckout true
echo ArkUISample/DrawableDescriptorSample > .git/info/sparse-checkout
git remote add origin https://gitcode.com/harmonyos_samples/guide-snippets.git
git pull origin master

